Tasks

Get a task's status and result

Return the current state of a task created by the key owner. Poll every few seconds until status is completed or failed; result_urls then lists the output files. A failed task refunds its credits.

get/api/v1/tasks/{id}

Request

Path parameters

idstring required

The task id returned by a generation endpoint.

Response

The task.

idstring required
type'video' | 'image' required
status'processing' | 'completed' | 'failed' | 'unknown' required

Poll while processing. completed and failed are final.

modelstring required
quality_tierstring nullable
channelstring nullable
resolutionstring nullable
credits_usednumber required
credits_refundednumber required
pricingobject nullable

Frozen pricing contract (Seedance 2.5 and Kling 4.0 tasks).

outputunknown required
result_urlsstring[] required

Every result file URL, flattened.

errorstring nullable required

Why the task failed, worded for API callers.

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.