Skip to main content
GET
Get music job status

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Path Parameters

job_id
string
required

The opaque job id returned by the create endpoint (e.g. aud_...).

Response

Current job status. audio_url is populated once succeeded.

audio_url
string<uri>

The generated track or sound effect (signed URL, valid at least 6 hours); present once status=succeeded, until expired is true.

completed_at
string<date-time>

When the job finished. Present once status is succeeded or failed (absent on jobs from before this field was added, October 2026).

created_at
string<date-time>

When the job was submitted.

error
string
expired
boolean

Present once status=succeeded. true after expires_at; no URLs are returned then.

expires_at
string<date-time>

Present once status=succeeded. When the outputs are deleted, 24 hours after created_at.

id
string
Example:

"aud_a1b2c3d4e5f6"

model
string
prompt
string

The prompt exactly as you submitted it; absent for lyrics-only songs.

started_at
string<date-time>

When processing started, i.e. when the job left the queue. Absent on jobs from before this field was added (October 2026).

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout
video_url
string<uri>

Video-to-sound-effect jobs only — the input video with the generated effects mixed in (signed URL, valid at least 6 hours); present once status=succeeded, until expired is true.