跳转到主要内容
千问 AI 平台 home page
文档
PixVerse

爱诗 PixVerse — 查询视频对口型任务结果

查询 PixVerse 视频对口型任务状态

GET
/tasks/{task_id}
cURL - 查询任务结果
# 将 {task_id} 替换为创建任务接口返回的 task_id
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "ddf8140e-67c6-9e70-8953-xxxxxx",
  "output": {
    "task_id": "1acb9d0c-7a63-4ff6-a198-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-07-15 17:01:49.352",
    "scheduled_time": "2026-07-15 17:01:49.398",
    "end_time": "2026-07-15 17:02:29.724",
    "video_url": "https://media.pixverseai.cn/xxxx.mp4"
  },
  "usage": {
    "duration": 7,
    "size": "1080*1920",
    "fps": 24,
    "video_count": 1,
    "SR": ""
  }
}
查询任务状态并获取生成的视频。

轮询策略

  1. 通过创建任务接口提交任务，保存返回的 task_id。
  2. 每 15 秒轮询一次，直到 task_status 变为 SUCCEEDED 或 FAILED。
  3. 任务成功后，从 video_url 下载视频。

注意事项

  • URL 有效期：video_url 在 24 小时后过期，请及时下载。
  • 状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。CANCELED 表示任务已取消。UNKNOWN 表示任务不存在或已过期（超过 24 小时）。

鉴权

​
string
header
必填

千问 AI 平台 API Key。详见获取 API Key。

路径参数

​
string
必填

任务 ID，来自创建任务接口的返回。查询有效期 24 小时。

响应

200-application/json
​
string

请求唯一标识。可用于请求明细溯源和问题排查。

​
object

任务输出信息。

​
object

输出信息统计，只对成功的结果计数。