Task Status
Check image, video, and music task results.
Task status
Use GET /v1/tasks/{id} to check a task created by the image, video, or music API.
Endpoint
GET /v1/tasks/{id}Required headers
Authorization: Bearer YOUR_API_KEYPath parameters
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task ID returned by the generation endpoint. |
Status values
| Status | Meaning |
|---|---|
pending | The task is waiting to start. |
processing | The task is being generated. |
success | The task is complete. Read the result URLs. |
failed | The task failed. Read errorMessage when present. |
canceled | The task was canceled. |
Example request
curl https://sseedance.com/v1/tasks/task_id \
-H "Authorization: Bearer YOUR_API_KEY"Example response
{
"object": "task",
"data": {
"id": "task_id",
"mediaType": "image",
"provider": "yunwu",
"model": "gpt-image-2-all",
"prompt": "A premium product photo",
"status": "success",
"imageUrls": ["https://cdn.example.com/image.png"],
"videoUrls": [],
"audioUrls": [],
"errorMessage": null
}
}Result fields
imageUrls: final image URLs for image tasks.videoUrls: final video URLs for video tasks.audioUrls: final audio URLs for music tasks.errorMessage: human-readable error message when a task fails.
If the task is still pending or processing, wait a short time and request the same task again.