Skip to main content
POST
Generate music with Music 3.0

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
format
enum<string>
default:wav

Output audio format. Defaults to wav (lossless); choose mp3 for a smaller file.

Available options:
wav,
mp3
instrumental
boolean
default:false

Generate an instrumental track (no vocals).

lyrics
string

Lyrics to sing (1-3500 characters). Required unless instrumental is true or lyrics_optimizer is true (the optimizer writes lyrics from the prompt).

lyrics_optimizer
boolean
default:true

Let the model write or polish lyrics from the prompt. Default true.

prompt
string

Style/mood description of the track (up to 2000 characters). Optional when lyrics are provided.

Response

Job accepted.

id
string

Opaque job id — use it to poll status.

Example:

"aud_a1b2c3d4e5f6"

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout