Retrieve Seedance task

Retrieves the information of a Seedance video generation task. Poll this endpoint until status is succeeded to get the video URL.

Task Statuses

queued: In the queue

running: Task is processing

succeeded: Task completed successfully

failed: Task failed

cancelled: Task was cancelled

expired: Task timed out

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Task information retrieved successfully

Body

Example

{
    "code": "success",
    "message": "",
    "data": {
        "id": 88,
        "created_at": 1772095377,
        "updated_at": 1772095426,
        "task_id": "task_n1GONEtW9YSqLFWmSFHtbUb7VAGZhXx8",
        "platform": "54",
        "user_id": 1,
        "group": "Seedance&Kling",
        "channel_id": 23,
        "quota": 128905,
        "action": "generate",
        "status": "SUCCESS",
        "fail_reason": "",
        "result_url": "https://example.com/video.mp4",
        "submit_time": 1772095377,
        "start_time": 1772095393,
        "finish_time": 1772095426,
        "progress": "100%",
        "properties": {
            "input": "",
            "upstream_model_name": "doubao-seedance-1-5-pro-251215",
            "origin_model_name": "doubao-seedance-1-5-pro-251215"
        },
        "data": {
            "content": {
                "video_url": "https://example.com/video.mp4"
            },
            "created_at": 1772095375,
            "draft": false,
            "duration": 5,
            "execution_expires_after": 172800,
            "framespersecond": 24,
            "generate_audio": true,
            "id": "cgt-20260226164255-6gxf6",
            "model": "doubao-seedance-1-5-pro-251215",
            "ratio": "16:9",
            "resolution": "720p",
            "seed": 78219,
            "service_tier": "default",
            "status": "succeeded",
            "updated_at": 1772095419,
            "usage": {
                "completion_tokens": 108900,
                "total_tokens": 108900
            }
        }
    }
}

🟠401Unauthorized

🟠404Not Found

🔴500Internal Server Error

Task Statuses#

Request

Request Code Samples

Responses

Task Statuses