API 文档AI 模型接口视频Vidu
查询生成物
根据任务 ID 查询 Vidu 视频生成任务状态与生成结果。生成物 URL 有效期 24 小时。
根据创建任务时返回的 task_id 查询任务状态与生成结果。生成物 URL、封面 URL、带水印 URL 均有效期 24 小时。
适用于文生视频、图生视频、参考生视频、首尾帧、对口型、视频延长等所有 Vidu 异步任务。
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
Endpoints
GET /vidu/ent/v2/tasks/{id}/creations
查询生成物
根据任务 ID 查询处理状态与生成物列表。
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | 任务 ID,由创建任务接口成功返回 |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | 请求身份认证。格式:Bearer sk-xxxxxx |
Responses
200: 成功查询任务
Content-Type: application/json
400: 请求参数错误
Content-Type: application/json
429: 请求频率限制
Content-Type: application/json
请求示例
curl -X GET "https://api.autorouter.top/vidu/ent/v2/tasks/{your_id}/creations" \
-H "Authorization: Bearer sk-xxxxxx"响应示例
{
"id": "your_task_id",
"state": "success",
"err_code": "",
"credits": 4,
"payload": "",
"creations": [
{
"id": "your_creations_id",
"url": "your_generated_results_url",
"cover_url": "your_generated_results_cover_url",
"watermarked_url": "your_generated_results_watermarked_url"
}
]
}响应字段说明:
| Name | Type | Description |
|---|---|---|
id | string | 任务 ID |
state | string | 处理状态。枚举:created(创建成功)、queueing(排队中)、processing(处理中)、success(成功)、failed(失败)。轮询过程中状态流转一般为 created / queueing → processing → success / failed |
err_code | string | 错误码,任务失败时返回 |
credits | integer | 该任务消耗的积分数量 |
payload | string | 本次任务调用时传入的透传参数 |
bgm | boolean | 本次任务是否使用 BGM |
off_peak | boolean | 本次任务是否使用错峰模式 |
creations | array | 生成物结果列表,仅成功时通常非空 |
creations[].id | string | 生成物 ID |
creations[].url | string | 生成物 URL,24 小时有效 |
creations[].cover_url | string | 生成物封面 URL,24 小时有效 |
creations[].watermarked_url | string | 带水印的生成物 URL,24 小时有效 |
错误处理
HTTP 401 / 403 鉴权错误
401 Unauthorized:API Key 无效或已过期403 Forbidden:API Key 无权访问此资源
HTTP 404 任务不存在
任务 ID 无效或不属于当前账号时可能返回未找到。
任务 failed 状态
见 err_code。失败时 AutoRouter 会自动退款到你的账户,可在日志页面查询退款记录。