Single task query

The /suno/fetch/{task_id} endpoint allows you to retrieve detailed status and results for a specific task. This is the primary endpoint for tracking the progress and obtaining results of asynchronous operations such as music generation, lyrics creation, audio uploads, and concatenation tasks.

Use this endpoint to monitor task completion and retrieve generated content including audio URLs, clip IDs, metadata, and other task-specific data.

Typical Workflow

For Music Generation:

Submit a music generation request via Generate music clip

Receive a task_id in the response

Poll this endpoint with the task_id until status becomes "SUCCESS"

Extract the generated music URLs and clip_id from the data field

Use the clip_id for further operations like continuation, concatenation, or obtaining MP4 videos and timing data

For Lyrics Generation:

Submit a lyrics generation request via Generate lyrics

Receive a task_id in the response

Poll this endpoint with the task_id until status becomes "SUCCESS"

Extract the generated lyrics text from the data field

Use the lyrics with the Generate music clip endpoint to create a complete song

{ "code": "success", "message": "", "data": { "task_id": "dcb812bd-40c5-4907-836e-3a7aa9a2e546", "action": "MUSIC", "status": "NOT_START", "fail_reason": "", "submit_time": 1747203819, "start_time": 1747203819, "finish_time": 0, "progress": "0%", "data": null } }

Typical Workflow

Request

Responses

Single task query

Typical Workflow#

Request

Responses

Typical Workflow