latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Music

Get a song

Returns a song you generated. Poll every 10-15 seconds after POST /music until status is completed (then use audioUrl, or the id as musicId in POST /music-videos) or failed (credits are refunded automatically).

get/music/{id}

Path parameters

idstring uuid required

Song ID from POST /music.

Response

OK

idstring uuid required
status'pending' | 'processing' | 'completed' | 'failed' required
titlestring nullable required

The song title when ready.

durationSecondsnumber nullable required

Track length in seconds when ready.

audioUrlstring nullable required

The finished audio URL when status is completed.

errorMessagestring nullable required

Why generation failed, when status is failed.