指定ID获取任务

开发中

GET

/seedance/v3/contents/generations/tasks/{task_id}

任务状态，以及相关的信息：
queued：排队中。
running：任务运行中。
cancelled：取消任务，取消状态24h自动删除（只支持排队中状态的任务被取消）。
succeeded：任务成功。
failed：任务失败。
expired：任务超时。

请求参数

Authorization

Path 参数

Header 参数

Body 参数application/json

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/seedance/v3/contents/generations/tasks/cgt-20260428145223-vx8jr' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "cgt-20260428145223-vx8jr",
    "url": "",
    "seed": 11217,
    "draft": false,
    "model": "doubao-seedance-2-0-fast-260128",
    "ratio": "16:9",
    "usage": {
        "total_tokens": 90814,
        "completion_tokens": 90814
    },
    "status": "succeeded",
    "content": {
        "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0-fast/02177735939905100000000000000000000ffffac14ddd02b8cc8.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260428%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260428T065824Z&X-Tos-Expires=86400&X-Tos-Signature=47fec974945d990cdc30290b0d2a8f9504badb2422cab0df33cf14e06dc67c16&X-Tos-SignedHeaders=host"
    },
    "duration": 4,
    "created_at": 1777359144,
    "resolution": "480p",
    "updated_at": 1777359558,
    "service_tier": "default",
    "generate_audio": true,
    "framespersecond": 24,
    "execution_expires_after": 172800
}

修改于 2026-04-28 07:20:22

提交视频生成任务