Documentation

API Credit System

Last Updated: October 15, 2025 Category: Billing

Overview

The Waymaker One API uses a credit system included with your WaymakerOne Pass subscription. Credits are consumed as you make API calls. Each subscription tier includes a monthly credit allocation — higher tiers include more credits along with additional compute, storage, and AI resources.

What is a Credit?

A credit is the unit of measurement for API usage in the Waymaker One platform.

Pricing:

1 credit = $0.01 (one cent)
100 credits = $1.00
1,000 credits = $10.00

Credits are deducted from your account balance each time you make an API call. The number of credits consumed depends on the complexity of the request and which AI agents are invoked.

Credit Allocation

Credits are included in your WaymakerOne Pass subscription tier. Higher tiers include more credits. When you need more capacity, upgrade your tier.

Credit Consumption by Agent

Different AI agents consume different amounts of credits based on their computational complexity and processing requirements.

Agent Credit Costs

Agent Type	Credits Per Call	Typical Use Case	Processing Time
Direct Response	1-3	Simple clarifications, quick answers	< 1 second
Framework Agent	10-15	Strategic framework analysis and guidance	2-5 seconds
Research Agent	15-25	Market research, competitive analysis	5-10 seconds
Data Agent	8-12	Analytics, data visualization	3-7 seconds
Multi-Agent Coordination	20-35	Complex strategic planning requiring multiple specialists	8-15 seconds

Note: Actual credit consumption varies based on:

Request complexity
Response length
Number of agents coordinated
Token usage (input + output)

Example Cost Calculations

Example 1: Simple Framework Question

Request:

{
  "messages": [{
    "role": "user",
    "content": "What is a Business Model Canvas?"
  }]
}

Agent Used: Direct Response Credits Consumed: ~2 credits Cost: $0.02

Example 2: Framework Analysis

Request:

{
  "messages": [{
    "role": "user",
    "content": "Help me create a Customer Journey Canvas for my e-commerce business"
  }]
}

Agent Used: Framework Agent Credits Consumed: ~12 credits Cost: $0.12

Example 3: Complex Multi-Agent Request

Request:

{
  "messages": [{
    "role": "user",
    "content": "Analyze our competitive position in the market and create a comprehensive strategic plan with implementation steps"
  }]
}

Agents Used: Research Agent + Framework Agent + coordination Credits Consumed: ~28 credits Cost: $0.28

Example 4: Conversation with Context

Request (continuing previous conversation):

{
  "messages": [
    {
      "role": "user",
      "content": "Help me with customer journey mapping"
    },
    {
      "role": "assistant",
      "content": "[Previous framework guidance...]"
    },
    {
      "role": "user",
      "content": "Now show me how to identify pain points"
    }
  ],
  "sessionId": "previous_session_123"
}

Agent Used: Framework Agent (with context) Credits Consumed: ~10 credits Cost: $0.10

💡 Tip: Continuing conversations uses slightly fewer credits than starting fresh because the agent has context.

Monitoring Credit Balance

Check Your Balance

Your current credit balance is always visible in the WaymakerOne dashboard:

Navigate to API Keys section
Your balance displays at the top: "Credits: 1,234 remaining"
View detailed usage in API Usage Analytics

Low Balance Alerts

When your credit balance drops below 100 credits (about $1 worth), you'll see:

Yellow warning banner in the dashboard
Recommendation to purchase more credits
Option to enable auto top-up

⚠️ Important: API calls will fail with 402 Payment Required if your balance reaches zero.

Credit Usage Analytics

View Your Consumption

Access detailed usage statistics in the API Usage section:

Overview Metrics:

Credits used today, this week, this month
Total API calls made
Total spend (credits × $0.01)
Projected monthly spend

Breakdown by Endpoint:

Which agents you're using most
Average credits per call
Cost per endpoint
Percentage of total usage

Daily Trends:

Credit consumption over time
Usage patterns and spikes
Cost forecasting

💡 Tip: Regular monitoring helps you optimize API usage and budget accordingly.

Credit Allocation Cycle

Credits are allocated as part of your subscription billing cycle. Your allocation refreshes each billing period.

Refund Policy

Purchase Refunds

Credit purchases are generally non-refundable because:

Credits are consumed immediately upon API use
Digital goods policy
Fraud prevention

Exceptions

Refunds may be issued in these cases:

Billing errors (double charges, incorrect amounts)
Service outages preventing API use
Unauthorized charges

To request a refund: Contact support@waymakerone.com with your purchase details and reason.

Best Practices

1. Monitor Your Allocation

Recommended for all users:

Review your tier's credit allocation against actual usage
Understand consumption patterns
Upgrade tier if you consistently approach your allocation limit

2. Monitor Usage Regularly

Check your API Usage Analytics dashboard:

Weekly for active developers
Daily for production applications
After making significant changes to API integration

3. Optimize Credit Consumption

Ways to reduce credit usage:

Cache common responses when appropriate
Use direct endpoints instead of coordination for known agent types
Batch related questions in conversation threads
Monitor which agents consume most credits
Adjust request complexity based on needs

4. Tier Planning

Estimate your monthly usage:

Average credits per call: 15 credits
Expected API calls per month: 500 calls
Monthly credits needed: 500 × 15 = 7,500 credits

Choose the subscription tier that covers your estimated usage.

Troubleshooting

"Insufficient credits" Error

Error Response:

{
  "error": "payment_required",
  "message": "Insufficient credits for this operation",
  "code": "INSUFFICIENT_CREDITS",
  "details": {
    "creditsRequired": 15,
    "creditsAvailable": 8
  }
}

Solution:

Check your credit balance in the dashboard
If you're consistently running low, upgrade your WaymakerOne Pass tier for a higher credit allocation

Credits Deducted But No Response

If you were charged credits but didn't receive a response:

Check the API Usage dashboard for the timestamp
Review the response status code
If status was 500 (server error), credits may be refunded automatically
Contact support@waymakerone.com if credits weren't refunded within 24 hours

Note: Partial responses still consume credits proportional to processing completed.

Unexpected High Credit Usage

If you're seeing higher credit consumption than expected:

Common causes:

Complex requests triggering multi-agent coordination
Long conversation contexts consuming more tokens
Repeated failed requests (each attempt consumes credits)
Using research/data agents instead of simpler framework queries

Solution:

Review your Usage by Endpoint breakdown
Identify which agents are consuming most credits
Optimize requests to use appropriate agent complexity
Consider conversation length and context size

Next Steps

Now that you understand how credits work, learn how to:

API Credits - How credits work with your subscription
Track API Usage - Monitor consumption patterns

Questions about credits? → Contact support@waymakerone.com

API Credit System

Overview

What is a Credit?

Credit Allocation

Credit Consumption by Agent

Agent Credit Costs

Example Cost Calculations

Example 1: Simple Framework Question

Example 2: Framework Analysis

Example 3: Complex Multi-Agent Request

Example 4: Conversation with Context

Monitoring Credit Balance

Check Your Balance

Low Balance Alerts

Credit Usage Analytics

View Your Consumption

Credit Allocation Cycle

Refund Policy

Purchase Refunds

Exceptions

Best Practices

1. Monitor Your Allocation

2. Monitor Usage Regularly

3. Optimize Credit Consumption

4. Tier Planning

Troubleshooting

"Insufficient credits" Error

Credits Deducted But No Response

Unexpected High Credit Usage

Next Steps

Related Articles