Credits and Billing
The Developer API uses a credit system. You can buy credits in addition to your plan at any time.
Credit Basics
| Rule | Value |
|---|---|
| Credit value | 1 credit = $0.01 |
| Free starter balance | 1,600 credits once |
| Standard plan | 2,400 credits/month |
| Pro plan | 4,800 credits/month |
You can buy credits in addition to your plan at any time.
Model Pricing
| Model | Best for | Typical time | Credits |
|---|---|---|---|
| Echo 2 - Standard | Fast, general-purpose world generation | ~8 minutes | 160 |
| Echo 2 (HQ) | Higher-detail, higher-resolution worlds | ~60 minutes | 800 |
What API Actions Cost
| API action | Echo 2 - Standard | Echo 2 (HQ) |
|---|---|---|
| Text-to-world generation | 160 credits | 800 credits |
| Image-to-world generation | 160 credits | 800 credits |
| Panorama-to-world generation | 160 credits | 800 credits |
Plans
| Plan | Credits | Echo 2 - Standard generations | Echo 2 (HQ) generations | API usage fit |
|---|---|---|---|---|
| Free | 1,600 once | 10 once | 2 once | Does not work with API |
| Standard | 2,400/month | 15 | 3 | Small integrations and prototypes |
| Pro | 4,800/month | 30 | 6 | Higher-volume API usage |
| Custom/Enterprise | Custom | Custom | Custom | Production or high-volume workloads |
Credit purchases are self-serve and can be custom amounts. Purchased credits are shared between the web app and API. Purchased credits are not part of your plan.
What Credits Can Pay for API Usage
Credit lives in one of two buckets. Plan credit is universal; free daily credit is reserved for the dashboard and can't be spent on API workloads.
| Bucket | Where it comes from | Dashboard (app) | API (v1) |
|---|---|---|---|
| Plan credit | Starter grant, subscription monthly credits, purchased top-ups, admin "Plan" grants | ✅ | ✅ |
| Free daily credit | Granted automatically each day for dashboard use (use-it-or-lose-it) | ✅ | ❌ |
In short: API world generation is paid for with plan credit (subscription credits, purchased top-ups, or the starter grant). There is no separate subscription gate — any plan credit works. Free daily credit never applies to API requests.
When you spend in the dashboard, credits are drawn plan → free daily (free spent last). When you spend via the API, only plan credit is drawn.
Insufficient Credits
If a world-generation request cannot reserve enough eligible credit, the API
returns a 402 with error.code = "insufficient_credits". This includes the
case where you only have free daily credit left — that can't pay for API usage.
Purchase credits or upgrade your plan in the developer portal before retrying.
{
"error": {
"code": "insufficient_credits",
"message": "You are out of credits. Purchase credits in the dashboard, request free credits in the developer portal, or email [email protected]."
}
}