注册

VIDU 任务状态查询

⚠️ 测试中

接口说明

VIDU 任务状态查询接口提供轻量级的任务状态查询。与 vidu-result 不同,status 接口只返回当前状态,不返回完整结果数据,适合需要频繁轮询状态的场景(如等待视频生成)。

建议工作流:先快速轮询 status,确认 succeeded 后再调用 vidu-result 获取完整结果。

GET https://api.quickrouter.ai/vidu/status 在线调试 →
Authorization

在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token

示例: Authorization: Bearer ********************

请求参数

Query 参数
task_id string
必需
异步任务的唯一标识符。

请求示例代码

curl --location --request GET 'https://api.quickrouter.ai/vidu/status?task_id=您的任务ID' --header 'Authorization: Bearer YOUR_API_KEY'
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.quickrouter.ai/vidu/status?task_id=您的任务ID", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
import http.client

conn = http.client.HTTPSConnection("api.quickrouter.ai")
headers = {
  'Authorization': 'Bearer YOUR_API_KEY'
}
conn.request("GET", "/vidu/status?task_id=您的任务ID", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

返回响应

响应参数 application/json
status string
可选
任务状态
task_id string
可选
任务ID
示例
{
    "status": "succeeded",
    "task_id": "vidu_task_jkl012"
}

状态说明

  • pending:任务已接收,等待调度处理
  • processing:正在生成中
  • succeeded:生成成功,调用 vidu-result 获取结果
  • failed:生成失败,查看 error 字段