Text to SFX

Generate SFX from text (sync)

Generate sound effects from a text prompt using the v1.6 model. Without looping: 0.1–60 s. With loop enabled: 1 s – 10 min (600000 ms) — long requests are automatically tiled server-side from a single seamless chunk. Blocks until complete.

post/v2/text-to-sfx/v1.6/sync

Request

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

Headers

Idempotency-Keystring

Stable key for one logical sync request, for retrying after an ambiguous response such as a transport timeout. Reuse it only with the identical body. While the original request is in progress, after it completed, or with a different body, the retry returns 409 idempotency_conflict instead of starting another billable request. A failed attempt may run again with the same key. A completed request's key is remembered for 24 to 48 hours after the original request completes, depending on when the daily sweep runs. A 409 retry does not extend this window; reusing the key after it is forgotten starts and bills a new request.

Request body

OR

Example request

{
  "prompt": "rain falling on leaves",
  "seed": 42,
  "output_format": "mp3"
}

Response

Generated audio URLs

modelstring nullable

Public release that produced this result. Null when unknown or when multiple releases contributed; not a runtime fingerprint or reproducibility guarantee.

result_urlsstring[] required

Array of URLs to the generated output files (audio, or video with SFX mixed in when output is "video"). Signed by the inference service at upload time and valid for one hour from then — not from when you read them. Prefer download_urls.

download_urlsstring[]

Short download links on mirelo.ai, index-aligned with result_urls when present. Each is a 302 to a URL signed at the moment you follow it, so the link stays valid for as long as the generation is retained instead of expiring on the job's clock. Short enough for clients that reject long URLs, and accepted anywhere this API takes an input URL. Repeated follows are expected and supported; a link followed hard enough to be throttled answers 429 with Retry-After rather than looking like a dead file. Optional — always fall back to result_urls. Every SFX endpoint emits it, extend and inpaint included; the music endpoints record no generation and so never carry one. Minting is best-effort on top of that, so even a response carrying generation_id may omit it.

generation_idstring

Server-side generation record id, present when the generation was persisted. Retain it to later reference the generation (e.g. attach feedback). Absent when persistence was skipped or failed — never blocks the result.

Changes

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