producer_get_task
Check the state of a music generation task and retrieve final audio URL, title, and lyrics only when 'state' is 'complete'.
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 (streaming preview URLs). These are 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 task timing metadata.
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 producer_generate_*, producer_extend_*, producer_cover_*, or other tool response. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |