Vidu — 查询结果

GET

/tasks/{task_id}

cURL

curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "cf7a3a1d-27b0-4d45-8b89-xxxxxx",
  "output": {
    "task_id": "88125b85-b53d-45f1-ba13-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 14:39:15.041",
    "scheduled_time": "2026-03-27 14:39:15.081",
    "end_time": "2026-03-27 14:40:03.428",
    "orig_prompt": "一只小猫从窗台向下跳跃，轻盈地落在沙发上，然后好奇地环顾四周。",
    "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx"
  },
  "usage": {
    "duration": 5,
    "size": "828*624",
    "output_video_duration": 5,
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "540"
  }
}

提交任务后，请调用此接口轮询任务状态。任务提交请参考生成视频。

轮询策略

调用生成视频接口，获取 task_id。
每隔 15 秒轮询，直到 task_status 为 SUCCEEDED 或 FAILED。
成功后，从 output.video_url 下载生成的视频。

注意事项

URL 有效期：视频链接自任务完成后 24 小时内有效，请及时下载。
状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）或 FAILED（失败）。CANCELED 表示任务已取消。UNKNOWN 表示任务不存在或查询已超过 24 小时。

常见问题

首帧和尾帧图像的顺序如何确定？ input.media 数组中，第一个元素为首帧（起始帧），第二个元素为尾帧（结束帧）。请按此顺序传入，否则生成效果可能不符合预期。 首帧和尾帧的分辨率有何限制？ 首帧和尾帧的总像素数（宽×高）比值需在 0.8～1.25 之间。比值过大或过小都会导致任务失败。

鉴权

string

header

必填

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

路径参数

string

必填

POST 接口返回的任务 ID。查询有效期为 24 小时。

响应

200-application/json

string

请求唯一标识。

示例:cf7a3a1d-27b0-4d45-8b89-xxxxxx

object

显示子属性

string

任务 ID。

示例:88125b85-b53d-45f1-ba13-xxxxxx

enum<string>

任务状态。状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。CANCELED 表示任务已取消。UNKNOWN 表示任务不存在或查询已过期（超过 24 小时）。

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

string

任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。仅在任务完成后返回。

示例:2026-03-27 14:39:15.041

string

任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。仅在任务完成后返回。

示例:2026-03-27 14:39:15.081

string

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

示例:2026-03-27 14:40:03.428

string

原始输入的 prompt，对应请求参数 prompt。仅在任务成功时返回。

示例:一只小猫从窗台向下跳跃，轻盈地落在沙发上，然后好奇地环顾四周。

string

生成的视频 URL（MP4 格式，H.264 编码）。仅在 task_status 为 SUCCEEDED 时返回。视频链接有效期为 24 小时，请及时下载。

示例:https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx

string

错误码。仅在任务失败时返回。

string

错误详细信息。仅在任务失败时返回。

object

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

显示子属性

integer

总的视频计费时长（秒）。

示例:5

string

输出视频的分辨率，格式为 宽*高。

示例:828*624

integer

输出视频的实际时长（秒）。

示例:5

integer

输出视频的帧率。

示例:24

boolean

输出视频是否为有声视频。

示例:false

string

输出视频的分辨率档位（垂直方向像素数）。

示例:540

integer

输出视频的数量。固定为 1。

示例:1

​轮询策略

​注意事项

​常见问题

鉴权

路径参数

响应

轮询策略

注意事项

常见问题