latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Music

List songs

Lists tracks in your music library: songs you generated with POST /music and audio you uploaded with POST /uploads (purpose music). Pick one to score a music video: use a generated song as musicId or an uploaded track as musicAssetId in POST /music-videos.

get/music

Response

idstring uuid required

For generated songs, use as musicId; for uploaded tracks, use as musicAssetId in POST /music-videos.

titlestring nullable required

Track title, if known.

durationSecondsnumber nullable required

Track length in seconds, if known.

status'pending' | 'processing' | 'completed' | 'failed' required

Generated songs report progress; uploaded tracks are always completed.

source'generated' | 'uploaded' required

generated (from POST /music) or uploaded (from POST /uploads).

audioUrlstring nullable required

The audio URL when the track is ready.