Query a music task by ID

Query the music generation task through path task_id.

Music generation task query API. The data returned by the create API is the task ID; use GET /suno/fetch/{task_id} to query a single task.

Query methods

GET /suno/fetch/task_xxx

Query output

Keep the outer new-api task structure:

• code: success on success.
• message: Error or message information.
• data.task_id: Task ID.
• data.status: Task status, common values are NOT_START, SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, and FAILURE.
• data.progress: Task progress.
• data.result_url: Result URL available after success. If the upstream returns multiple songs, the fragment in data.data prevails.
• data.data: Raw upstream music result data, usually containing an array or object of song fragments.

Success example:

{
 "code": "success",
 "message": "",
 "data": {
 "task_id": "task_xxx",
 "platform": "suno",
 "action": "MUSIC",
 "status": "SUCCESS",
 "progress": "100%",
 "result_url": "https://example.com/audio.mp3",
 "properties": {
 "upstream_model_name": "suno_music",
 "origin_model_name": "suno-v5"
 },
 "data": [
 {
 "id": "clip_xxx",
 "title": "夏日海风",
 "audio_url": "https://example.com/audio.mp3",
 "image_url": "https://example.com/cover.jpg",
 "model_name": "suno-v5",
 "metadata": {
 "duration": 180,
 "prompt": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}