任务查询
开发中
GET
https://otuapi.com/v1/videos/{task_id}
任务查询接口文档
接口地址
GET /v1/videos/{task_id}功能说明
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务ID，由提交接口返回 |
请求示例
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务ID |
| object | string | 对象类型：video（视频）或 image（图片） |
| model | string | 使用的模型名称 |
| status | string | 任务状态：queued（排队中）、processing（处理中）、completed（已完成）、failed（失败） |
| progress | number | 任务进度，0-100 |
| created_at | number | 创建时间戳（秒） |
| completed_at | number | 完成时间戳（秒，仅completed状态返回） |
| url | string | 结果URL（仅completed状态返回），视频或图片的下载地址 |
| error | string | 错误信息（仅failed状态返回） |
响应示例
排队中
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "sora-2-landscape-10s",
"status": "queued",
"progress": 0,
"created_at": 1709876543
}处理中
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "veo_3_1-fast",
"status": "processing",
"progress": 45,
"created_at": 1709876543
}已完成（视频）
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "sora-2-landscape-10s",
"status": "completed",
"progress": 100,
"created_at": 1709876543,
"completed_at": 1709876600,
"url": "https://example.com/videos/xxx.mp4"
}已完成（图片 - Nano Banana）
{
"id": "task_xxxxxxxxxxxxx",
"object": "image",
"model": "nano_banana_2",
"status": "completed",
"progress": 100,
"created_at": 1709876543,
"completed_at": 1709876580,
"url": "https://example.com/images/xxx.jpg"
}失败
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "sora-2-landscape-10s",
"status": "failed",
"progress": 0,
"created_at": 1709876543,
"error": "生成失败：内容违规"
}错误码说明
| HTTP状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 404 | 任务不存在 |
| 401 | 未授权 |
| 500 | 服务器内部错误 |
注意事项
1.
2.
3.
status 为 completed 时，才会返回 url 字段4.
/v1/videos 提交的任务（Sora视频、Veo视频、Nano Banana图片生成等）5.
请求参数
Path 参数
Header 参数
请求示例代码
返回响应
修改于 2026-05-10 04:45:30