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

NameTypeRequiredDescription
idstringYes任务 ID,由创建任务接口成功返回

Headers

NameTypeRequiredDescription
AuthorizationstringYes请求身份认证。格式: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"
    }
  ]
}

响应字段说明:

NameTypeDescription
idstring任务 ID
statestring处理状态。枚举:created(创建成功)、queueing(排队中)、processing(处理中)、success(成功)、failed(失败)。轮询过程中状态流转一般为 created / queueingprocessingsuccess / failed
err_codestring错误码,任务失败时返回
creditsinteger该任务消耗的积分数量
payloadstring本次任务调用时传入的透传参数
bgmboolean本次任务是否使用 BGM
off_peakboolean本次任务是否使用错峰模式
creationsarray生成物结果列表,仅成功时通常非空
creations[].idstring生成物 ID
creations[].urlstring生成物 URL,24 小时有效
creations[].cover_urlstring生成物封面 URL,24 小时有效
creations[].watermarked_urlstring带水印的生成物 URL,24 小时有效

错误处理

HTTP 401 / 403 鉴权错误

  • 401 Unauthorized:API Key 无效或已过期
  • 403 Forbidden:API Key 无权访问此资源

HTTP 404 任务不存在

任务 ID 无效或不属于当前账号时可能返回未找到。

任务 failed 状态

err_code。失败时 AutoRouter 会自动退款到你的账户,可在日志页面查询退款记录。

目录