Vidu — 查询图生视频任务结果（基于首帧）

查询 Vidu 图生视频（基于首帧）任务状态，获取生成的视频

GET

/api/v1/tasks/{task_id}

cURL

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

{
  "request_id": "3606f9f4-b833-44ec-8385-xxxxxx",
  "output": {
    "task_id": "2846881f-0496-4288-947f-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 14:25:32.057",
    "scheduled_time": "2026-03-27 14:25:32.084",
    "end_time": "2026-03-27 14:28:29.600",
    "orig_prompt": "镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。",
    "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxxx"
  },
  "usage": {
    "duration": 5,
    "size": "988*932",
    "output_video_duration": 5,
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720"
  }
}

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

轮询策略

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

注意事项

URL 有效期：视频 URL 在任务完成后 24 小时过期，请及时下载保存。
视频格式：生成的视频为 MP4 格式，编码为 H.264。
状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。CANCELED：任务已被取消。UNKNOWN 表示任务不存在或已过期（超过 24 小时）。

鉴权

string

header

必填

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

路径参数

string

必填

提交任务时返回的 task_id。

响应

200-application/json

string

本次请求的唯一 ID。

object

显示子属性

string

异步任务 ID。

enum<string>

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

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

string

任务提交时间。

string

任务开始调度时间。

string

任务结束时间（成功或失败时返回）。

string

原始提示词（任务成功时返回）。

string

生成视频的 URL，有效期 24 小时，请及时下载保存。视频格式为 MP4，编码为 H.264。

string

任务失败时的错误码。

string

任务失败时的错误信息。

object

任务成功时返回的用量信息。

显示子属性

integer

请求的视频时长（秒）。

integer

实际生成的视频时长（秒）。

string

生成视频的分辨率，格式为 宽*高，例如 988*932。

integer

生成视频的帧率。

integer

生成的视频数量。

boolean

生成的视频是否包含音频。

string

分辨率档位，例如 720（720P）。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项