Skip to main content
POST
Generate music with Sonilo Music

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 (up to 2000 characters; even a few words work), e.g. "30 seconds of upbeat electronic instrumental for a product launch video, no vocals".

duration
integer
default:30

Length of the track in seconds (5-360). Billed per second with a 10-second minimum.

Required range: 5 <= x <= 360
format
enum<string>
default:mp3

Output audio format.

Available options:
mp3,
wav

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