Skip to main content
POST
Generate music with Lyria 3

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Description of the music to generate (10-2000 characters).

images
string[]

Optional reference images (up to 10) to condition the track's mood/theme. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads.

Maximum array length: 10
lyrics
string

Optional lyrics (up to 3000 characters).

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