简体中文

English

简体中文

English

主题

Seedance 任务查询 ​

Seedance 2.0 任务提交后，按 task_id 查询状态、进度与结果。

http
GET /v1/video/generations/{task_id}

将路径中的 {task_id} 替换为 视频生成 返回的任务 ID。完成后结果视频地址位于 data.data.content.video_url。

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：

请求参数 ​

名称类型必填说明
string是路径参数，视频生成任务 ID，与创建接口返回的 task_id 一致

请求示例 ​

bash
curl https://octopusx.ai/v1/video/generations/cgt-20260412163502-x8k2m \
  -H "Authorization: Bearer <token>"

响应示例 ​

json
{
  "code": "success",
  "data": {
    "task_id": "task_xxxxx",
    "status": "IN_PROGRESS",
    "progress": "50%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 0,
    "data": {
      "status": "processing",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {}
    }
  }
}
json
{
  "code": "success",
  "data": {
    "task_id": "task_xxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 1775908321,
    "data": {
      "status": "succeeded",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {
        "video_url": "https://example.com/output.mp4"
      },
      "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
      }
    }
  }
}
json
{
  "code": "success",
  "data": {
    "task_id": "task_xxxx",
    "status": "FAILURE",
    "progress": "100%",
    "submit_time": 1775908082,
    "start_time": 1775908086,
    "finish_time": 1775908200,
    "fail_reason": "Content safety check failed",
    "data": {
      "status": "failed",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "content": {}
    }
  }
}

响应字段 ​

名称类型说明
string业务状态码，成功为
string任务 ID
string任务状态：、、
string进度（字符串百分比，如 ）
integer提交时间戳
integer开始时间戳
integer完成时间戳
string失败原因（失败时出现）
string内部状态：、、
string完成后的结果视频地址
objectToken 用量（成功后出现）

相关接口 ​