Skip to main content

​
Credits

World API billing is separate from Marble web app billing.If you plan to use the API, make sure you purchase credits on the World Labs Platform, not in the Marble app.
The World Labs API uses a credit-based pricing model. You may purchase credits at a fixed rate of $1.00 USD per 1,250 credits through the World Labs Platform. The minimum purchase is 6,250 credits or $5.00 USD. API credits do not expire. You can check your current API credit balance with GET /marble/v1/credits.

​
Auto-refill

You may enable auto-refill to avoid service interruptions by automatically purchasing credits when your balance is low. On the billing page, you may enable and configure auto-refill once you have a payment method on file. You may configure the threshold at which auto-refill is triggered, as well as the target balance to refill to.
Note that when auto-refill is triggered, your balance will not settle at the target balance. This is because the refill is applied before the cost of the API request is deducted from your balance.For example, assume your threshold is 10,000 credits and your target balance is 20,000 credits, and you have a balance of 10,000 credits.
  1. You make an API request that costs 1,500 credits. We would observe that your balance would drop to 8,500 credits, which is below your threshold.
  2. The auto-refill would then be triggered and you would be charged to bring your balance to 20,000 credits.
  3. Finally, your balance would drop to 18,500 credits to charge for the API request.

​
Usage events

Credits are consumed as you use the API. API requests may map to one or more usage events, and each usage event may have its own cost in credits associated with it. The total cost of an API request is the sum of the costs of all the usage events it maps to. The cost of each usage event is determined largely by the compute resources required to complete the underlying operation. You may view your usage event history in the usage page. Note that not all API requests consume credits, such as API key creation, media asset upload and management, and Operation polling. If an API request cannot start because your account is out of credits, the API returns 402 Payment Required with a response body that links to the billing page, where you can add credits or enable auto-refill.

​
World generation pricing

Generating a world using the World Generation API is the most common API request. However, the number of usage events and the cost of generating a world depends on the input type. The World Generation API requires a panorama image (pano) to convert into a 3D world, so it first generates a pano from your input if a pano is not provided. Image prompts use is_pano: "auto" by default; when the API detects a valid equirectangular pano, it skips pano generation. As a result, a World Generation API request often includes two usage events:
  1. Pano generation (if needed)
  2. World generation (from pano)
For Marble 1.0 / marble-1.0 and Marble 1.1 / marble-1.1, the world generation usage event is billed at 1,500 credits. Draft world generation (marble-1.0-draft) is billed at 150 credits. For Marble 1.1 Plus / marble-1.1-plus, a request always includes 1 world generation event billed at 1,500 credits. For larger worlds, our system may automatically determine to include up to 1,500 additional credits for variable world generation. Depending on your input type, you may also incur a pano generation usage event. If you generate from an existing pano and the API treats it as a pano, there is no pano generation step, so there is no additional pano generation cost.

​
Usage event costs

​
Draft model totals (marble-1.0-draft)

​
Standard model totals (marble-1.0, marble-1.1)

​
Marble 1.1 Plus totals (marble-1.1-plus)

​
Observed Marble 1.1 Plus costs

The variable world generation charge depends on the size of the world, so actual costs vary by request. The table below shows observed succeeded marble-1.1-plus World Generation API costs through June 25, 2026. 1,250 credits = $1.00. Overall marble-1.1-plus costs across these input types:
  • Mean: $1.714
  • Median: $1.280
  • P75/P90: $2.464
  • P95/P99/max: $2.480

​
Mesh export pricing

Exporting a high-quality mesh with the Export API ({"asset_type": "mesh", "format": "glb"}) is billed as a single HQ mesh export usage event of 3,500 credits ($2.80). A single export run produces both mesh variants (textured and vertex_colored), so you are charged once per world, not once per variant. You are only charged when a new export run starts:
  • If the world already has an exported mesh, the API returns the cached result at no cost.
  • If a mesh export is already running for the world, the API returns the existing operation at no cost.
PLY splat exports ({"asset_type": "splats", "format": "ply"}) are free.