Text to SFX

Preflight

Returns the exact credit cost and estimated duration for a text-to-sfx generation. No generation occurs, no credits are deducted.

get/v2/text-to-sfx/v1.5/preflight

Request

  • Base URL: https://api.mirelo.ai
  • URL: https://api.mirelo.ai/v2/text-to-sfx/v1.5/preflight
  • Auth: HTTP bearer

Query parameters

duration_msinteger

Duration in milliseconds

num_samplesinteger

Number of samples

Response

Credit cost and ETA

creditsinteger required

Exact credit cost — matches what will be deducted on success

billing_mode'metered' | 'unmetered' required

unmetered organization requests are affordable without evaluating credit fields

credits_requiredinteger required

Exact credits required by the request

credits_availableinteger nullable required

Reservation-aware financial capacity, including enabled overage headroom; non-ready provisioning can still block spending

credit_shortfallinteger required

Additional financial capacity required; 0 means capacity covers the request, but non-ready provisioning can still block it

recovery_action'enable_overage' | 'increase_overage_limit' | 'view_plans' | 'contact_support' nullable required

Server-recommended next step; honor a non-null action even when credit_shortfall is 0

recovery_urlstring uri nullable required

Destination for recovery_action

provisioning_state'ready' | 'pending' | 'stalled' nullable required

Included-credit grant state. Any non-ready state blocks spending; pending waits for provisioning_deadline and stalled follows recovery_action.

provisioning_deadlineinteger nullable required

ms epoch when pending provisioning becomes stalled

estimated_msinteger required

Estimated completion time in milliseconds (p90 calibrated)

Changes

No recorded changes to this operation across all 1 revision of this API.