Skip to main content

​
Credit-Based Usage

Each API request costs credits based on the capabilities used. Credits pay for orchestration, tool execution, sandboxing, and file storage — your own LLM key covers the AI inference (see BYOK).
CapabilityCreditsDescription
Chat1Conversational AI
Data1Structured data processing
Files2File upload/download via signed URLs
Research3Web search + synthesis
Code3Sandboxed code execution
Documents5PDF/report generation
A request using multiple capabilities costs the sum of their weights. For example, a request with capabilities: ["research", "documents"] costs 8 credits.

​
Getting Credits

Every account starts with 200 free credits (replenished monthly). When you need more, purchase credit packs:
PackPricePer Credit
1,000 credits$8$0.008
5,000 credits$30$0.006
25,000 credits$100$0.004
100,000 credits$300$0.003
Purchased credits never expire. Buy what you need, when you need it.

Purchase credits

Buy credit packs from your dashboard.

​
How Credits Are Charged

Credits are pre-deducted before your request is processed. If the compute service fails, credits are automatically refunded to your balance. When your balance reaches zero, requests return a 402 status: 
{
  "error": {
    "code": "insufficient_credits",
    "message": "No credits remaining. Purchase credits at https://www.stewrd.dev/pricing"
  }
}

​
Rate Limits

All requests are rate-limited to 60 requests per minute. If you exceed this, you’ll receive a rate_limited error with HTTP status 429. Wait and retry with exponential backoff. 
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Limit: 60/minute."
  }
}

​
Usage Tracking

Every response includes current usage in the usage object: 
{
  "usage": {
    "credits_remaining": 4758,
    "credits_this_request": 3,
    "tokens_used": 847
  }
}
FieldDescription
credits_remainingYour credit balance after this request
credits_this_requestCredits consumed for this specific request
tokens_usedLLM tokens consumed for this specific request

​
Response Headers

Every response includes a credit balance header:
HeaderDescription
X-Credits-RemainingYour credit balance after this request
Free accounts receive 200 credits per month, automatically replenished. Purchased credits never expire and stack on top of any free allocation.