Billing and limits
Understand cloud-export credits, workspace limits, and API-key usage caps.
Cloud exports consume credits from the API key's workspace. The workspace's plan also determines available resolutions, frame rates, and concurrent exports. An API key can have its own export-usage limit.
How export credits are calculated
The baseline is 100 credits per minute at 1280 × 720 and 30 fps. Cost scales with output pixel area and frame rate, with a minimum resolution factor of 0.65. At 60 fps, the frame-rate factor is 2.
Duration is rounded up to a whole second. After applying the resolution and frame-rate factors, usage is rounded up to a whole standard second.
resolution factor = max(output width × output height / (1280 × 720), 0.65)
billedStandardSeconds = ceil(ceil(durationSeconds) × resolution factor × frame-rate factor)
credits = billedStandardSeconds × 100 / 60Use the values returned by the API for accounting. Fractional credits are represented as decimal strings in chargedCredits.
Examples for one minute
| Output | Standard seconds | Credits |
|---|---|---|
| 960 × 540, 30 fps | 39 | 65 |
| 1280 × 720, 30 fps | 60 | 100 |
| 1920 × 1080, 30 fps | 135 | 225 |
| 2560 × 1440, 30 fps | 240 | 400 |
| 3840 × 2160, 30 fps | 540 | 900 |
| 1280 × 720, 60 fps | 120 | 200 |
These examples describe pricing; they do not grant permission to export at a resolution or frame rate outside your workspace's plan.
Read usage from a response
durationSecondsdescribes the output duration.billedStandardSecondsmeasures the normalized export usage.chargedCreditsrecords the export's credit charge as a decimal string.
Export creation, task snapshots, and export webhooks include these fields. Store them with taskId when reconciling your application's usage.
Workspace limits
Cloud exports created in the app, through the API, or through an agent share the workspace's export concurrency limit. There is no single fixed concurrency value for every workspace.
Choose an output permitted by the workspace's subscription. Exports below 4K support up to 26 minutes; exports at or above 3840 × 2160 pixel area support up to 15 minutes. Other request validation and plan limits still apply.
Buying credits does not by itself increase the plan's concurrency, resolution, or frame-rate entitlement. Review the workspace's current plan in Indream for available output settings.
API-key usage limits
An API key's configured cap limits its accumulated export usage in standard seconds. It is separate from the workspace's credit balance. Do not assume the cap resets monthly.
OPEN_API_EXPORT_STANDARD_SECOND_LIMIT_EXCEEDED means the key cannot accept that export under its current limit. Review the key's cap instead of continuously retrying. For other failures, see Errors and retries.
Last updated on