Skip to main content
Poll this endpoint to check the status of your music generation task.
If the create response included poll_url, prefer calling that exact URL for polling. /v1/tasks/{id} is the canonical fixed status endpoint for music jobs, and id / task_id should be treated as the same async task identity.If the task no longer exists or is no longer available in the public task record, AI Sonar returns async_task_not_found with the message Task not found or no longer available.

Path Parameters

string
required
The music generation task ID.

Response

string
Task ID.
string
Async task identifier alias when provided.
string
Preferred polling URL when the create response supplies one.
string
Task status: pending, processing, completed, or failed.
integer
Optional progress value. Returned only when a real progress value is available; use status to determine completion.
string
URL to download the audio file (when completed).
string
URL to the video version with visualizer (when completed).
string
Generated song title.
string
Generated or provided lyrics.
string
Error message (when failed).