Skip to main content
POST
Generate a music track

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
prompt
string
required

The music you want: genre, mood, tempo, instruments, e.g. warm lo-fi beat with soft piano, 85 bpm

Required string length: 3 - 1000
seconds
integer
default:60
required

How long, 10 to 180 seconds. Default 60: a track shorter than the video loops.

Required range: 10 <= x <= 180
instrumental
boolean
default:true
required

No vocals. Default true: vocals compete with narration.

max_price_cents
integer

A spending cap: a track priced above it is refused with 400 and nothing is made

Required range: 0 <= x <= 9007199254740991

Response

Success

data
object
required