爱诗 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": "19171ea5-9efb-4d35-93a1-xxxxxx",
  "output": {
    "task_id": "7ed706b7-a9a9-4319-820c-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-07-14 10:34:41.630",
    "scheduled_time": "2026-07-14 10:34:41.655",
    "end_time": "2026-07-14 10:35:12.725",
    "video_url": "https://media.pixverseai.cn/xxxx.mp4"
  },
  "usage": {
    "duration": 6,
    "size": "3840*2156",
    "fps": 24,
    "video_count": 1,
    "SR": "4K"
  }
}

查询任务状态并获取生成的视频。

轮询策略

通过创建任务接口提交任务，保存返回的 task_id。
每 15 秒轮询一次，直到 task_status 变为 SUCCEEDED 或 FAILED。
任务成功后，从 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

任务输出信息。

显示子属性

string

任务 ID。查询有效期 24 小时。

enum<string>

任务状态。状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。CANCELED 表示任务已取消，UNKNOWN 表示任务不存在或状态未知。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

string

任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。

string

任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。仅在任务状态为 SUCCEEDED 或 FAILED 时返回。

string

视频 URL。仅在 task_status 为 SUCCEEDED 时返回。视频格式为 MP4（H.264 编码）。视频链接暂无过期时间，但不建议将其作为长期存储依赖，请及时下载。

示例:https://media.pixverseai.cn/xxxx.mp4

string

请求失败的错误码。请求成功时不会返回此参数。

string

请求失败的详细信息。请求成功时不会返回此参数。

object

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

显示子属性

integer

计费时长（秒）。为用户上传视频时长向上取整。

string

输出视频的分辨率。固定输出 4K（3840×2160）。

integer

输出视频的帧率。

integer

视频数量，固定为 1。

string

输出视频的分辨率档位。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项