Vidu 查询结果

查询 Vidu 异步任务的状态和生成文件。创建任务返回的 task_id 就是这里的路径参数 id。

接口信息

方法	GET
路径	/ent/v2/tasks/{id}/creations
完整地址	https://api000.com/ent/v2/tasks/{id}/creations

---

请求头

参数	必填	示例
Authorization	是	Bearer sk-xxxxxxxxxxxxxxxx

---

路径参数

参数	类型	必填	说明
id	string	是	创建任务接口返回的 task_id

---

请求示例

curl https://api000.com/ent/v2/tasks/911084878697623552/creations \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx"

---

任务状态

state	说明
created	任务已创建
queueing	排队中
processing	生成中
success	生成成功
failed	生成失败

---

成功响应

{
  "id": "911084878697623552",
  "type": "character2video",
  "model": "viduq3",
  "state": "success",
  "progress": 100,
  "duration": 5,
  "credits": 45,
  "payload": "",
  "err_code": "",
  "err_msg": "",
  "creations": [
    {
      "id": "creation_01",
      "url": "https://example.com/result.mp4",
      "cover_url": "https://example.com/cover.jpg"
    }
  ]
}

---

返回字段

字段	类型	说明
id	string	任务 ID
state	string	当前任务状态
progress	integer	生成进度，成功时通常为 100
credits	integer	上游返回的消耗信息
payload	string	创建任务时传入的自定义字段
err_code	string	失败错误码
err_msg	string	失败错误信息
creations	array	生成结果列表
creations[].url	string	生成视频或文件 URL
creations[].cover_url	string	封面 URL，部分任务可能为空

---

轮询示例

import time
import requests

api_key = "sk-xxxxxxxxxxxxxxxx"
task_id = "911084878697623552"

while True:
    resp = requests.get(
        f"https://api000.com/ent/v2/tasks/{task_id}/creations",
        headers={"Authorization": f"Bearer {api_key}"},
        timeout=30,
    )
    data = resp.json()

    if data.get("state") == "success":
        print(data["creations"][0]["url"])
        break

    if data.get("state") == "failed":
        raise RuntimeError(data.get("err_msg") or data.get("err_code") or "Vidu task failed")

    time.sleep(5)