suno_get_task
Retrieve the status and result of a music generation task. Polls until complete, providing audio URLs, titles, lyrics, and metadata when finished.
Instructions
Query the status and result of a music generation task.
Use this to check if a generation is complete and retrieve the resulting
audio URLs, titles, lyrics, and other metadata.
Use this when:
- You want to check if a generation has completed
- You need to retrieve audio URLs from a previous generation
- You want to get the full details of a generated song
Task states:
- 'pending': Generation is still in progress — KEEP POLLING
- 'processing': Generation is being processed — KEEP POLLING
- 'complete': Generation finished successfully — this is the ONLY state that means done
- 'failed': Generation failed (check error message)
CRITICAL: During the 'pending' state, the response may already contain intermediate
audio_url values (e.g. URLs from audiopipe.suno.ai). These are STREAMING PREVIEW URLs,
NOT final results. You MUST check the 'state' field — only present the results to the
user when state is 'complete' and success is true. Do NOT stop polling just because
audio_url is non-empty.
Returns:
Task status and generated audio information including URLs, title, lyrics, and duration.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | The task ID returned from a generation request. This is the 'task_id' field from any suno_generate_*, suno_extend_*, suno_cover_*, or suno_concat_* tool response. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |