跳转到主要内容
千问 AI 平台 home page
文档
Vidu

Vidu — 查询结果

查询 Vidu 文生视频任务的状态与生成结果。

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": "eda50dad-a6d3-4e62-a70b-26bbb797ae81",
  "output": {
    "task_id": "d9254244-1f9b-4b4c-be82-d9560ba25708",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 13:32:13.962",
    "scheduled_time": "2026-03-27 13:32:14.008",
    "end_time": "2026-03-27 13:32:43.375",
    "orig_prompt": "一只小猫在月光下奔跑",
    "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx"
  },
  "usage": {
    "duration": 5,
    "size": "960*528",
    "output_video_duration": 5,
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "540"
  }
}
提交任务后，建议每隔 15 秒轮询一次该接口，直到 task_status 为 SUCCEEDED 或 FAILED。

任务状态流转

PENDING → RUNNING → SUCCEEDED 或 FAILED
状态说明
PENDING任务排队等待中
RUNNING任务生成中
SUCCEEDED任务成功，可获取视频链接
FAILED任务失败，查看 code 和 message 字段获取原因
CANCELED任务已取消
UNKNOWN任务不存在或已过期（超过 24 小时）
  • 成功响应中的 video_url 有效期为 24 小时，请及时下载视频。
  • 查询接口的 QPS 限制为 8 次/秒。
  • 支持配置异步回调，免去主动轮询。详见配置异步回调。
  • 如需取消任务或批量管理任务，参见管理异步任务。

常见问题

size 和 resolution 有什么区别？
  • size 直接指定输出视频的宽高（像素），优先级高于 resolution。
  • resolution 指定分辨率档位（540P / 720P / 1080P），可与 size 配合使用；两者均传入时以 size 为准。
  • 推荐使用 size 精确控制输出尺寸，可用值参见提交视频任务中的 size 参数取值对照表。

错误码

请参见错误信息。

鉴权

​
string
header
必填

千问 AI 平台 API Key。详见获取 API Key。

Header 参数

​
string
必填

千问 AI 平台 API Key。详见获取 API Key。

路径参数

​
string
必填

任务 ID。将上一步接口返回的 task_id 完整替换。查询有效期为 24 小时。

响应

200-application/json
​
string

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

示例:eda50dad-a6d3-4e62-a70b-26bbb797ae81
​
object

任务输出信息。

​
object

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