Skip to main content
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 files array will be empty until the task status is finished
  • When a task fails, check the error_message field for details
  • Multiple audio files may be returned for a single task as variations are generated

Response Fields (files data)

The files 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 track
  • instrumental_url - URL to the instrumental track

upload-and-separate-vocals

vocal_removal fields:
  • bass - URL to the bass track
  • drums - URL to the drums track
  • piano - URL to the piano track
  • guitar - URL to the guitar track
  • vocals - URL to the vocals track
  • other - URL to other audio elements

stem-split

stem_split fields:
  • backing_vocals_url - URL to backing vocals
  • bass_url - URL to bass track
  • brass_url - URL to brass instruments
  • drums_url - URL to drums track
  • fx_url - URL to sound effects
  • guitar_url - URL to guitar track
  • keyboard_url - URL to keyboard track
  • percussion_url - URL to percussion track
  • strings_url - URL to strings track
  • synth_url - URL to synthesizer track
  • vocal_url - URL to main vocals
  • woodwinds_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 image
  • file_type - File type (e.g., “image”)

Authorizations

Authorization
string
header
required

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

task_id
string
required

Unique task identifier returned from the music generation submission endpoint.

Response

200 - application/json

Task detail retrieved successfully

code
integer
required

HTTP status code

Example:

200

data
object
required