跳转到主要内容
千问云 home page
开放平台文档
首帧（DashScope V1）

爱诗 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": "7df19cf7-d76c-4bb8-b4c5-xxxxxx",
  "output": {
    "task_id": "5abf2c85-ea81-4cbf-8918-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-20 11:48:50.499",
    "scheduled_time": "2026-03-20 11:48:50.551",
    "end_time": "2026-03-20 11:49:46.462",
    "orig_prompt": "镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。",
    "video_url": "https://media.pixverseai.cn/xxxx.mp4"
  },
  "usage": {
    "duration": 5,
    "shot_type": "single",
    "size": "992*944",
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}
查询任务状态并获取生成的视频。

轮询策略

  1. 调用提交图生视频任务（基于首帧）接口获取 task_id。
  2. 每 15 秒轮询一次，直到 task_status 为 SUCCEEDED、FAILED 或 CANCELED。
  3. 任务成功后，从 output.video_url 获取视频。

注意事项

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

鉴权

​
string
header
必填

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

路径参数

​
string
必填

提交任务时返回的 task_id。

响应

200-application/json
​
string

本次请求的唯一 ID。

示例:7df19cf7-d76c-4bb8-b4c5-xxxxxx
​
object
​
object

资源消耗信息，仅在任务 SUCCEEDED 时返回。