Sign in

v1

latestOpenAPI 3.1.0Terms of Service2026-07-134612.6 KB
Tasks

Get task status and result

Retrieve a task by id. Poll this endpoint until status is one of success, failure, or timeout. Tasks older than 1 hour in pending or running state automatically transition to timeout with a refund.

get/api/v1/task/{taskId}

Path parameters

taskIdstring uuid required

Task ID returned by POST /api/v1/task.

Response

Task details

task_idstring uuid required
model'suno' required
type'music' | 'lyrics' | 'upload' | 'concat' required
status'pending' | 'running' | 'success' | 'failure' | 'timeout' required
credits_costinteger required
inputobject

The input payload as originally submitted.

outputobject nullable

Present on success. Shape varies by task type. For music, includes result array with audio_url, image_url, etc.

errorstring nullable

Present on failure or timeout.

created_atstring date-time nullable
completed_atstring date-time nullable