任务查询与轮询

curl https://gogogotoken.com/v1/video/generations/task_1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gogogotoken.com/v1/video/generations?request_id=YOUR_X_ONEAPI_REQUEST_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS",
    "progress": "50%"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://assets.example.com/generated-video.mp4",
    "upstream_task_id": "cgt-20260827173939-xxxxx",
    "billing": {
      "status": "settled",
      "currency": "CNY",
      "quota": 220273,
      "amount": "0.440546",
      "billable_tokens": 108900,
      "billing_token_field": "total_tokens",
      "model_ratio": 11.5,
      "group_ratio": 0.78,
      "variant_ratio": 0.6086956521739131,
      "promo_ratio": 0.4,
      "promo_at": 1787823579,
      "input_mode": "with_video",
      "generate_audio": true,
      "list_price_per_m_tokens": "23",
      "effective_price_per_m_tokens": "4.367983",
      "settled_at": 1787823681
    },
    "data": {
      "id": "cgt-20260827173939-xxxxx",
      "model": "doubao-seedance-2-0-mini-260615",
      "status": "succeeded",
      "seed": 58950,
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 4,
      "framespersecond": 24,
      "generate_audio": true,
      "service_tier": "default",
      "created_at": 1787823581,
      "updated_at": 1787823666,
      "content": {
        "video_url": "https://assets.example.com/generated-video.mp4"
      },
      "usage": {
        "completion_tokens": 100858,
        "total_tokens": 100858
      }
    }
  }
}

{
  "id": "task_1234567890",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://assets.example.com/generated-video.mp4"
  }
}

GET

video

generations

{task_id}

curl https://gogogotoken.com/v1/video/generations/task_1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gogogotoken.com/v1/video/generations?request_id=YOUR_X_ONEAPI_REQUEST_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS",
    "progress": "50%"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://assets.example.com/generated-video.mp4",
    "upstream_task_id": "cgt-20260827173939-xxxxx",
    "billing": {
      "status": "settled",
      "currency": "CNY",
      "quota": 220273,
      "amount": "0.440546",
      "billable_tokens": 108900,
      "billing_token_field": "total_tokens",
      "model_ratio": 11.5,
      "group_ratio": 0.78,
      "variant_ratio": 0.6086956521739131,
      "promo_ratio": 0.4,
      "promo_at": 1787823579,
      "input_mode": "with_video",
      "generate_audio": true,
      "list_price_per_m_tokens": "23",
      "effective_price_per_m_tokens": "4.367983",
      "settled_at": 1787823681
    },
    "data": {
      "id": "cgt-20260827173939-xxxxx",
      "model": "doubao-seedance-2-0-mini-260615",
      "status": "succeeded",
      "seed": 58950,
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 4,
      "framespersecond": 24,
      "generate_audio": true,
      "service_tier": "default",
      "created_at": 1787823581,
      "updated_at": 1787823666,
      "content": {
        "video_url": "https://assets.example.com/generated-video.mp4"
      },
      "usage": {
        "completion_tokens": 100858,
        "total_tokens": 100858
      }
    }
  }
}

{
  "id": "task_1234567890",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://assets.example.com/generated-video.mp4"
  }
}

视频生成任务提交后，通过 task_id 轮询查询任务状态与生成结果。SD2 推荐路径：GET /v1/video/generations/{task_id}。若提交响应丢失，可用创建时响应头中的 X-Oneapi-Request-Id 做按 request_id 找回。

两种查询路径返回结构不同，请与提交路径保持一致：

GET /v1/video/generations/{task_id}（SD2 主路径）→ {code, data: TaskDto}，status 为大写（如 IN_PROGRESS、SUCCESS），视频地址在 data.result_url，上游原始 JSON（含 usage）在 data.data
GET /v1/videos/{task_id}（OpenAI 兼容）→ 扁平 {id, object, status, progress, metadata.url}，status 为小写（如 in_progress、completed）

curl https://gogogotoken.com/v1/video/generations/task_1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://gogogotoken.com/v1/video/generations?request_id=YOUR_X_ONEAPI_REQUEST_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS",
    "progress": "50%"
  }
}

{
  "code": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://assets.example.com/generated-video.mp4",
    "upstream_task_id": "cgt-20260827173939-xxxxx",
    "billing": {
      "status": "settled",
      "currency": "CNY",
      "quota": 220273,
      "amount": "0.440546",
      "billable_tokens": 108900,
      "billing_token_field": "total_tokens",
      "model_ratio": 11.5,
      "group_ratio": 0.78,
      "variant_ratio": 0.6086956521739131,
      "promo_ratio": 0.4,
      "promo_at": 1787823579,
      "input_mode": "with_video",
      "generate_audio": true,
      "list_price_per_m_tokens": "23",
      "effective_price_per_m_tokens": "4.367983",
      "settled_at": 1787823681
    },
    "data": {
      "id": "cgt-20260827173939-xxxxx",
      "model": "doubao-seedance-2-0-mini-260615",
      "status": "succeeded",
      "seed": 58950,
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 4,
      "framespersecond": 24,
      "generate_audio": true,
      "service_tier": "default",
      "created_at": 1787823581,
      "updated_at": 1787823666,
      "content": {
        "video_url": "https://assets.example.com/generated-video.mp4"
      },
      "usage": {
        "completion_tokens": 100858,
        "total_tokens": 100858
      }
    }
  }
}

{
  "id": "task_1234567890",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://assets.example.com/generated-video.mp4"
  }
}

路径参数

string

required

视频生成任务 ID（提交响应中的 id / task_id）。

请求头

string

required

API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。

按 request_id 找回任务

提交接口超时、客户端未读到 body，但服务端可能已创建成功时：

GET /v1/video/generations?request_id=<X-Oneapi-Request-Id>

项	说明
`request_id`	必填。取自首次创建响应头 `X-Oneapi-Request-Id`
有效期	约 24 小时
权限	仅能查到当前 API Key 所属用户自己的任务
成功响应	与幂等重放相同形态的 OpenAI Video 任务对象（含 `id` / `task_id`）；响应头可能含 `X-Idempotency-Replayed: true`
未找到	HTTP 404，`task_not_found`（过期、未落库，或无 task_id 的失败创建）

生产集成优先在提交时带 Idempotency-Key，用同一业务键重试即可拿回原任务；request_id 找回适合「没带幂等键、但保存了响应头」的补救路径。

string

网关请求 ID。与路径参数 task_id 二选一场景使用：本接口为查询串形式，无 path 中的 task_id。

响应体（`/v1/video/generations/{task_id}`）

string

任务状态：QUEUED、IN_PROGRESS、SUCCESS、FAILURE 等。

string

进度百分比字符串，如 "50%"。

string

生成成功后的视频 URL（平台提取自上游响应）。

string

上游火山方舟原始任务 ID（cgt-...），可用于官方控制台核对。早期创建的任务无此字段时缺省。

object

本任务结算快照：结算状态（pending / settled / refunded）、最终扣费额度 quota 与金额 amount、计费 token 数 billable_tokens，以及提交时锁定的价格参数（model_ratio / group_ratio / variant_ratio / promo_ratio / input_mode 等）。金额与单价为十进制字符串；复算口径见计费说明。

object

上游任务查询的完整原始响应：实际模型版本 model、实际生成规格（resolution / ratio / duration / framespersecond / seed / generate_audio / service_tier）、完整 usage 等。请求 duration=-1（智能时长）时，此处的 duration 为官方最终选择的实际输出时长。

integer

Token 计费模型（doubao-seedance-2-0 / -fast）的上游真实输出 token。结算口径以 data.billing.billable_tokens 为准（取自 usage.total_tokens，两者在 Seedance 任务中恒等）。

data.data 的完整度依赖后台轮询刷新：提交后立刻查询时 data 内仅有上游任务 ID，进入终态（SUCCESS / FAILURE）前请等待一轮刷新（约 15 秒）。

轮询建议

状态通常按以下顺序变化：

QUEUED / IN_PROGRESS -> SUCCESS / FAILURE

成功后的 result_url 约 24 小时内有效，请及时下载。

开始使用

图片生成

对话模型

Seedance 视频

Kling 视频

Seedance 素材

兼容接口

账户与计费

路径参数

请求头

按 request_id 找回任务

响应体（`/v1/video/generations/{task_id}`）

轮询建议

​路径参数

​请求头

​按 request_id 找回任务

​响应体（/v1/video/generations/{task_id}）

​轮询建议

路径参数

请求头

按 request_id 找回任务

响应体（`/v1/video/generations/{task_id}`）

轮询建议