platform-api

Generate music with a frozen price and one provider submission; Idempotency-Key required

post/v1/music

Request

  • Base URL: https://api.cuddler.ai
  • URL: https://api.cuddler.ai/v1/music
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Required. One key per logical request (e.g. ep03-shot042-take1), never reusable: the same key and body answer with the original object and Idempotent-Replayed: true; the same key with a different body is 409 (and so is any reuse once the job's request trace was removed, 180 days after it finished).

Request body

model'lyria-3-pro' | 'lyria-3' | 'lyria-2' | 'eleven-music-2.5' required
promptstring required
output_format'mp3'
max_usdstring

Maximum USD this job may charge; creation refuses a larger hold and settlement never exceeds this ceiling

webhook_urlstring uri
metadataobject

Response

Idempotent replay

object'music' required
idstring required
model'lyria-3-pro' | 'lyria-3' | 'lyria-2' | 'eleven-music-2.5' required
status'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' required
created_atstring required
started_atstring nullable required
completed_atstring nullable required
queue_positioninteger nullable required
price_versionstring required
api_key_idstring required
metadataobject required

Changes

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