跳转到主要内容
创建 Seedance 2.0 视频生成任务后，使用此端点轮询任务状态并在完成后获取结果。

​
端点

GET /v1/video/generations/{task_id}

​
快速示例

curl https://ai.alad.com/v1/video/generations/asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E \
  -H "Authorization: Bearer YOUR_API_KEY"

​
任务状态

data.status含义后续动作
NOT_START任务已接收，尚未排队继续轮询
QUEUED排队中继续轮询
IN_PROGRESS处理中（progress 从 50% 开始递进）继续轮询，建议 15s 间隔
SUCCESS完成读取 data.result_url
FAILURE失败读取 data.fail_reason，平台自动退费
视频生成约需 1-5 分钟。result_url 有效期 24 小时——请立即下载或转存。

​
顶层响应字段

字段类型说明
data.task_idstring平台任务 ID（格式 asyntask_xxx）
data.actionstring任务子类型：generate、referenceGenerate、firstTailGenerate、omniGenerate
data.statusstring任务状态（见上表）
data.result_urlstring预签名下载 URL，有效期 24 小时。失败任务此字段省略
data.original_result_urlstring仅超分任务返回。 上游原始（增强前）视频 URL
data.fail_reasonstring失败时为错误信息。历史兼容：成功时该字段会被复制为 result_url 的值，兼容老客户端
data.submit_timeint64提交时间戳（Unix 秒）
data.start_timeint64上游开始时间戳；未开始为 0
data.finish_timeint64完成时间戳
data.progressstring进度百分比文本，如 "50%"、"100%"
data.request_idstring请求溯源 ID
data.dataobject上游原始输出（见下文）

​
data.data — 上游原始输出

字段说明
content.video_url生成的视频 URL（普通任务等同于外层 result_url）
id上游任务 ID
model上游模型 ID
duration视频时长（秒）
ratio宽高比
resolution上游原始分辨率。超分任务为下调后的上游分辨率，用户感知的最终分辨率在 super_resolution 字段
super_resolution仅超分任务返回。 超分后的最终分辨率（如 720p、2k）
framespersecond帧率
generate_audio是否生成了音频
seed使用的随机种子
status上游状态（succeeded、failed、running 等）
usage.completion_tokens上游原始 completion tokens
usage.total_tokens上游原始 total tokens
usage.super_resolution_tokens仅超分任务返回。 超分系数应用后的 token 数，对应实际计费 token

​
成功响应（普通任务）

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E",
    "action": "generate",
    "status": "SUCCESS",
    "result_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...mp4?...",
    "fail_reason": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...mp4?...",
    "submit_time": 1777288506,
    "start_time": 1777288508,
    "finish_time": 1777288800,
    "progress": "100%",
    "request_id": "20260427111505260254000NBdvZFoP",
    "data": {
      "content": {"video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...mp4?..."},
      "id": "cgt-20260427191505-9j2q7",
      "model": "doubao-seedance-2-0-260128",
      "duration": 5,
      "ratio": "16:9",
      "resolution": "720p",
      "framespersecond": 24,
      "generate_audio": true,
      "seed": 4304,
      "status": "succeeded",
      "usage": {"completion_tokens": 108900, "total_tokens": 108900}
    }
  }
}

​
成功响应（超分任务）

超分模型（如 seedance-turbo）走”上游低分辨率生成 + MediaKit 超分增强”两阶段流程，相比普通任务多以下字段： 
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_2cEAvaCpERzvSo7wfCCPZmNlGx8cjnu4",
    "action": "generate",
    "status": "SUCCESS",
    "result_url": "https://...vod.cn-north-1.volcvideo.com/...?preview=1&auth_key=...",
    "original_result_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...mp4?...",
    "fail_reason": "https://...vod.cn-north-1.volcvideo.com/...?preview=1&auth_key=...",
    "submit_time": 1777288507,
    "start_time": 1777288509,
    "finish_time": 1777288834,
    "progress": "100%",
    "request_id": "20260427111507187625000wErxKeB6",
    "data": {
      "content": {"video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...mp4?..."},
      "id": "cgt-20260427191507-f5n97",
      "duration": 5,
      "ratio": "16:9",
      "resolution": "480p",
      "super_resolution": "720p",
      "usage": {
        "completion_tokens": 50638,
        "total_tokens": 50638,
        "super_resolution_tokens": 114441
      }
    }
  }
}
注意 data.resolution = "480p" 是上游原始值（系统将用户请求的 720p 在请求阶段下调到 480p 发给上游以节省成本）；data.super_resolution = "720p" 才是用户感知到的最终分辨率。

​
失败响应

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_xxx",
    "action": "generate",
    "status": "FAILURE",
    "fail_reason": "task failed, code: InvalidParameter, message: img_url must be set for image to video method",
    "submit_time": 1775802896,
    "start_time": 0,
    "finish_time": 1775802902,
    "progress": "100%",
    "request_id": "..."
  }
}
平台自动退还预扣额度——无需调用方操作。

API 参考

查看 Seedance 2.0 任务查询 的交互式 API Playground。