Skip to main contentCredits
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. 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.
- 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.
- The auto-refill would then be triggered and you would be charged to bring your balance to 20,000 credits.
- 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.
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 will first generate a pano from your input if a pano is not provided. As a result, a World Generation API request often includes two usage events:
- Pano generation (if needed)
- World generation (from pano)
The world generation usage event is billed at 1,500 credits for Standard / Marble 0.1-plus, and 150 credits for Draft / Marble 0.1-mini.
Depending on your input type, you may also incur a pano generation usage event. If you generate from an existing pano, there is no pano generation step, so there is no additional cost.
Pricing (Standard / Marble 0.1-plus)
| Input type | Pano generation | World generation | Total |
|---|
| Image (pano) | 0 | 1,500 | 1,500 |
| Text | 80 | 1,500 | 1,580 |
| Image (non-pano) | 80 | 1,500 | 1,580 |
| Multi-image | 100 | 1,500 | 1,600 |
| Video | 100 | 1,500 | 1,600 |
Pricing (Draft / Marble 0.1-mini)
| Input type | Pano generation | World generation | Total |
|---|
| Image (pano) | 0 | 150 | 150 |
| Text | 80 | 150 | 230 |
| Image (non-pano) | 80 | 150 | 230 |
| Multi-image | 100 | 150 | 250 |
| Video | 100 | 150 | 250 |
