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.

​
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.

​
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:
  1. Pano generation (if needed)
  2. 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 typePano generationWorld generationTotal
Image (pano)01,5001,500
Text801,5001,580
Image (non-pano)801,5001,580
Multi-image1001,5001,600
Video1001,5001,600

​
Pricing (Draft / Marble 0.1-mini)

Input typePano generationWorld generationTotal
Image (pano)0150150
Text80150230
Image (non-pano)80150230
Multi-image100150250
Video100150250