# 查询视频任务（豆包原生）
> 查询以豆包原生格式提交的视频任务状态与结果
> 状态流转：pending → processing → succeeded / failed
> 建议每 5 秒查询一次，10 分钟仍未完成可放弃
`GET /doubao/api/v3/contents/generations/tasks/{task_id}`
## 认证
- `Authorization` (string / 必填) — 所有接口均使用 Bearer Token 进行认证。 Seedance 系列的接口需要在 [ark 站](https://ark.oairoute.com/) 单独获取 Key，与 api 站的 Key 不通用。 请求时在请求头中添加： ```http Authorization: Bearer YOUR_ARK_KEY ```
## 路径参数
- `task_id` (string / 必填) — 提交任务时返回的任务 ID。
## 状态流转
```text
pending -> processing -> succeeded   成片可取
                      -> failed      查看 error 字段
```
- `pending`：已受理，排队中
- `processing`：生成中
- `succeeded`：已完成，成片地址在 `content.video_url`
- `failed`：已失败，原因在 `error.message`
轮询节奏：每 5 秒一次，总超时约 10 分钟。多数 Seedance 任务在 1 到 3 分钟内完成。
## 响应
- `id` (string) — 任务 ID。
- `model` (string) — 实际使用的模型。
- `status` (string) — 取值 `pending`、`processing`、`succeeded`、`failed`。
- `content.video_url` (string) — 成功时返回的成片地址。
- `content.last_frame_url` (string) — 末帧图片地址。提交时把 `return_last_frame` 设为 `true` 才会返回，与成片同时产出，同样是带签名的临时地址。
- `seed` (integer) — 本次实际使用的种子。
- `resolution` (string) — 实际输出分辨率。
- `duration` (integer) — 实际输出秒数。
- `ratio` (string) — 实际输出画幅比例。
- `framespersecond` (integer) — 实际输出帧率。
- `service_tier` (string) — 实际生效的服务档位。
- `usage.completion_tokens` (integer) — 上游返回时才有。
- `usage.total_tokens` (integer) — 上游返回时才有。
- `error.code` (string) — 失败时返回，如 `content_policy_violation`。
- `error.message` (string) — 失败时的错误描述。
- `created_at` (integer) — 创建时间，Unix 秒。
- `updated_at` (integer) — 状态更新时间，Unix 秒。
## 错误码
| HTTP | 含义 |
|---|---|
| 401 | Token 缺失或无效，type 为 authentication_error |
更多状态码与重试建议见[错误码与限流](../../support/errors.html)，常见报错的排查步骤见[常见问题](../../support/faq.html)。
## 使用示例
**排队中{Queued}::cURL**
```
curl --request GET \
  --url https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456 \
  --header 'Authorization: Bearer YOUR_ARK_KEY'
```
**排队中{Queued}::Python**
```
import requests
url = "https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456"
headers = {"Authorization": "Bearer YOUR_ARK_KEY"}
res = requests.get(url, headers=headers)
print(res.json())
```
**排队中{Queued}::JavaScript**
```
const res = await fetch("https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456", {
  headers: { Authorization: "Bearer YOUR_ARK_KEY" },
});
console.log(await res.json());
```
**200 排队中{Queued}**
```
{
  "id": "task_abc123def456",
  "model": "seedance-2.5",
  "status": "pending",
  "created_at": 1763088289,
  "updated_at": 1763088289
}
```
**生成中{Processing}::cURL**
```
curl --request GET \
  --url https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456 \
  --header 'Authorization: Bearer YOUR_ARK_KEY'
```
**生成中{Processing}::Python**
```
import requests
url = "https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456"
headers = {"Authorization": "Bearer YOUR_ARK_KEY"}
res = requests.get(url, headers=headers)
print(res.json())
```
**生成中{Processing}::JavaScript**
```
const res = await fetch("https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456", {
  headers: { Authorization: "Bearer YOUR_ARK_KEY" },
});
console.log(await res.json());
```
**200 生成中{Processing}**
```
{
  "id": "task_abc123def456",
  "model": "seedance-2.5",
  "status": "processing",
  "created_at": 1763088289,
  "updated_at": 1763088300
}
```
**已完成{Succeeded}::cURL**
```
curl --request GET \
  --url https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456 \
  --header 'Authorization: Bearer YOUR_ARK_KEY'
```
**已完成{Succeeded}::Python**
```
import requests
url = "https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456"
headers = {"Authorization": "Bearer YOUR_ARK_KEY"}
res = requests.get(url, headers=headers)
print(res.json())
```
**已完成{Succeeded}::JavaScript**
```
const res = await fetch("https://ark.oairoute.com/doubao/api/v3/contents/generations/tasks/task_abc123def456", {
  headers: { Authorization: "Bearer YOUR_ARK_KEY" },
});
console.log(await res.json());
```
**200 已完成{Succeeded}**
```
{
  "id": "task_abc123def456",
  "model": "seedance-2.5",
  "status": "succeeded",
  "content": {
    "video_url": "https://cdn.example.com/videos/output-abc123.mp4",
    "last_frame_url": "https://cdn.example.com/videos/output-abc123_last-frame.png"
  },
  "seed": 42,
  "resolution": "1080p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24,
  "created_at": 1763088289,
  "updated_at": 1763088400
}
```