response
What you actually get back
One response shape on every plan. Same fields, same polling rules, no tier-specific surprises after you scale.
01 · shape
Four things, every time
- audiohosted file URL, duration, tempo hint
- taskstable id — re-poll without spending credits
- rightslicence tier and identification code, chosen in the request
- refundfailed or stuck generation returns its credits automatically
02 · rights
Rights arrive with the audio
The licence tier is chosen in the request, so the identification code and the permitted-use wording come back with the file — not in a later email, and not in a PDF you have to store somewhere.
worldwideperpetualirrevocableterms snapshotted at payment
polling
Free to ask, cheap to wait
Poll the task id; each poll returns the same shape. Polling never spends credits, and a finished task stays readable.
failure
Failure is refunded, not argued
A failed generation, or one that never reaches a terminal state, returns its credits automatically. You do not open a ticket to get them back.
| Field | Type | Notes |
|---|---|---|
| task_id | string | stable for the lifetime of the task |
| status | enum | queued · running · succeeded · failed |
| audio_url | string | signed, hosted; copy it when the job completes |
| duration_s | number | master duration, not the requested length |
| tempo_hint | number | detected bpm; advisory, never a guarantee |
| licence | object | tier + identification code, chosen in the request |