create.new_sample
Submit a sample generation request.
Returns immediately with status: processing. Use the matching GET to
poll for completion, or supply a callback_url to receive a webhook.
Samples are short audio clips generated from a text prompt at the
requested duration. Set loopable: true to produce a clip designed to
repeat seamlessly. A prompt rejected by our content policy returns the
operation as failed with tos_violation.
Credits cost: 3 per request. Insufficient credits returns 402 —
see errors.
Body
A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.
Free-text description of the audio to generate. Mix tags, a description of the desired mood and instrumentation, and a scene — use commas to separate tags. Examples: rock song, energetic, male vocal (song), synthwave, melancholic, mid-tempo (instrumental), rock, guitar, energetic, no drums (sample), someone typing on a keyboard (effect).
1 - 1024Duration in seconds.
Optional HTTPS URL we'll POST the final response to when the operation reaches ready or failed. Polling remains the canonical source of truth; webhooks are a best-effort latency optimisation.
1 - 2048Whether the sample should be designed to loop seamlessly.
Response
Successful Response
