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	`800 credits` once
Standard plan	`7,500 credits/month`
Pro plan	`15,000 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	800 once	5 once	1 once	Evaluation and prototypes
Standard	7,500/month	~46	~9	Standard Echo and Echo HQ; non-commercial use
Pro	15,000/month	~93	~18	Standard Echo and Echo HQ; commercial use
Enterprise	Custom	Custom	Custom	Multiple users and Echo 3 API access

Standard and Pro subscribers can purchase additional credits. Purchased credits are shared across the app, web app, and API. Paid plans are available monthly or annually; annual plans save 20% and grant credits monthly. New subscriptions include a card-required first month free.

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. Choose a plan or purchase additional credits in the dashboard."
  }
}

Credit Basics​

Model Pricing​

What API Actions Cost​

Plans​

What Credits Can Pay for API Usage​

Insufficient Credits​