Query Music Generation Detail
Music Series
Query Music Detail
Query detailed results of music generation tasks
GET
Query Music Generation Detail
Usage Guide
- All POST submission requests in the Music Series can query their results through this endpoint. Different models will return different response fields.
Parameter Details
task_id(required): The unique task identifier returned from the music generation submission endpoint
Developer Notes
- Poll this endpoint to check task completion status
- The
filesarray will be empty until the task status isfinished - When a task fails, check the
error_messagefield for details - Multiple audio files may be returned for a single task as variations are generated
Response Fields (files data)
Thefiles array content varies depending on which model created the task.
JSON Field Details
separate-vocals
separate_vocals fields:
vocal_url- URL to the extracted vocal trackinstrumental_url- URL to the instrumental track
upload-and-separate-vocals
vocal_removal fields:
bass- URL to the bass trackdrums- URL to the drums trackpiano- URL to the piano trackguitar- URL to the guitar trackvocals- URL to the vocals trackother- URL to other audio elements
stem-split
stem_split fields:
backing_vocals_url- URL to backing vocalsbass_url- URL to bass trackbrass_url- URL to brass instrumentsdrums_url- URL to drums trackfx_url- URL to sound effectsguitar_url- URL to guitar trackkeyboard_url- URL to keyboard trackpercussion_url- URL to percussion trackstrings_url- URL to strings tracksynth_url- URL to synthesizer trackvocal_url- URL to main vocalswoodwinds_url- URL to woodwinds track
generate-music-cover
generate_cover is a JSON array containing cover image objects:
file_url- URL to the generated cover imagefile_type- File type (e.g., “image”)
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Query Parameters
Unique task identifier returned from the music generation submission endpoint.