查询任务
GET /v1/video/generations/{task_id}的别名- 状态、响应字段完全一致
- 供遵循 OpenAI Video API 路径约定的客户端使用
认证
所有接口均使用 Bearer Token 进行认证。
Seedance 系列的接口需要在 ark 站 单独获取 Key，与 api 站的 Key 不通用。
请求时在请求头中添加：
Authorization: Bearer YOUR_ARK_KEYAll endpoints authenticate with a Bearer token.
Seedance series endpoints require a key obtained separately from the ark site; it isn't shared with the api site's key.
Add it to the request header:
Authorization: Bearer YOUR_ARK_KEY与 /v1/video/generations/{task_id} 的关系
两条路径查询的是同一个任务，差别在响应外壳：`/v1/videos/{task_id}` 直接返回扁平对象（本页），`/v1/video/generations/{task_id}` 把同一个对象包在 `data` 里，并沿用 `QUEUED`、`IN_PROGRESS`、`SUCCESS`、`FAILURE` 这组状态值。字段含义两边一致，选一条固定下来即可，不要在同一条链路里混用。
完整字段说明见查询视频任务（OpenAI 兼容）。
Both paths poll the same task and differ only in the response envelope: /v1/videos/{task_id} returns a flat object (this page), while /v1/video/generations/{task_id} puts the same object inside data and uses the QUEUED, IN_PROGRESS, SUCCESS and FAILURE status values. Field meanings are identical on both sides; pick one path and stick to it rather than mixing them in one pipeline.
For the full field reference see Poll a video task (OpenAI-compatible).
路径参数
提交任务时返回的任务 ID。
The task ID returned when the task was submitted.
响应
| 字段 | 说明 |
|---|---|
| `id` | 任务 ID |
| `object` | 固定为 `video` |
| `model` | 实际使用的模型 |
| `status` | `queued`、`in_progress`、`completed`、`failed` |
| `progress` | 进度百分比，整数 0 到 100 |
| `created_at` | 创建时间，Unix 秒 |
| `completed_at` | 结束时间，Unix 秒，`completed` 后出现 |
| `video_url` | 成片直链，`completed` 后出现 |
| `last_frame_url` | 末帧图片地址，上游产出末帧时才有；两者都是带签名的临时地址 |
| `data` | 上游返回的原始任务快照，结构与原生查询接口一致 |
| `error` | 失败时的错误码与描述 |
| Field | Description |
|---|---|
| `id` | The task ID |
| `object` | Always `video` |
| `model` | The model actually used |
| `status` | `queued`, `in_progress`, `completed`, `failed` |
| `progress` | Progress percentage, an integer from 0 to 100 |
| `created_at` | Creation time, in Unix seconds |
| `completed_at` | End time, in Unix seconds; appears after `completed` |
| `video_url` | The direct video link; appears after `completed` |
| `last_frame_url` | The trailing-frame image URL, present only when the upstream produces one; both are signed, expiring addresses |
| `data` | The raw upstream task snapshot, shaped like the native poll endpoint |
| `error` | Error code and description on failure |
错误码
| HTTP | Meaning |
|---|---|
| 401 | Token missing or invalid, with type authentication_error |
For more status codes and retry guidance see Error codes and rate limits; for troubleshooting steps on common errors see the FAQ.