跳转到主要内容
首尾帧

PixVerse — 查询结果

查询 PixVerse 首尾帧图生视频任务状态

GET
/tasks/{task_id}
cURL
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "40799260-689c-4c44-9d7c-xxxxxx",
  "output": {
    "task_id": "408b6c3b-27c9-43dd-b928-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-20 13:47:42.916",
    "scheduled_time": "2026-03-20 13:47:42.949",
    "end_time": "2026-03-20 13:48:41.896",
    "orig_prompt": "一只小猫从窗台向下跳跃,轻盈地落在沙发上,然后好奇地环顾四周。",
    "video_url": "https://media.pixverseai.cn/xxx.mp4"
  },
  "usage": {
    "duration": 5,
    "size": "1280*960",
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}
查询任务状态并获取生成的视频。

轮询策略

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

注意事项

  • URL 有效期video_url 当前无过期时间限制,但不建议将其作为长期存储,请及时下载。
  • 状态流转PENDINGRUNNINGSUCCEEDED / FAILED

鉴权

string
header
必填

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

路径参数

string
必填

任务ID。将 {task_id} 完整替换为创建任务接口返回的 task_id 的值。

响应

200-application/json
string

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

40799260-689c-4c44-9d7c-xxxxxx
object

任务输出信息。

object

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