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

PixVerse — 查询参考生视频结果

查询 PixVerse 参考生视频任务状态

GET
/tasks/{task_id}
查询任务结果
# 将 {task_id} 替换为创建任务接口返回的实际 task ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "35137489-2862-96cb-b6f2-xxxxxx",
  "output": {
    "task_id": "1469cfc3-3004-4d9e-ab10-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-10 15:03:25.848",
    "scheduled_time": "2026-03-10 15:03:25.884",
    "end_time": "2026-03-10 15:04:05.882",
    "orig_prompt": "男人坐在靠窗的椅子上，手持吉他，在咖啡厅旁演奏一首舒缓的美国乡村民谣",
    "video_url": "https://media.pixverseai.cn/xxxx.mp4"
  },
  "usage": {
    "duration": 5,
    "size": "1280*720",
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}
轮询任务状态，任务完成后下载视频。响应包含时间戳和原始提示词，便于追踪。

轮询策略

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

注意事项

  • 链接有效期：视频下载链接在 24 小时后失效，请及时下载。
  • 状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。
  • 任务过期：长时间未查询的任务可能返回 UNKNOWN 状态，表示任务已过期。
  • 计量详情：响应中的 usage 字段返回视频时长、分辨率、帧率等计量信息。

鉴权

​
string
header
必填

千问云 API Key。详见获取 API Key。

Header 参数

​
string
必填

千问云 API Key。详见获取 API Key。

路径参数

​
string
必填

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

响应

200-application/json
​
string

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

​
object

任务输出信息。

​
object

输出信息统计。只对成功的结果返回。