跳转到主要内容
千问云 home page
开放平台文档
HappyHorse

HappyHorse -- 查询文生视频结果

查询 HappyHorse 文生视频任务状态

GET
/tasks/{task_id}
cURL - 查询任务结果
# 将 {task_id} 替换为提交任务时返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "99243b47-ec5f-9413-9993-xxxxxx",
  "output": {
    "task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-20 17:55:17.075",
    "scheduled_time": "2026-04-20 17:55:17.129",
    "end_time": "2026-04-20 17:56:36.658",
    "orig_prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。",
    "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9"
  }
}
轮询任务状态，任务成功后下载视频。

轮询策略

  1. 保存提交任务响应中的 task_id。
  2. 每 15 秒轮询本接口，直到 task_status 为 SUCCEEDED 或 FAILED。
  3. 在 24 小时内通过 video_url 下载视频 -- 链接过期后将无法访问。

鉴权

​
string
header
必填

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

路径参数

​
string
必填

提交任务时返回的任务 ID。

响应

200-application/json
​
string

请求唯一标识。联系技术支持时请提供此 ID。

示例:99243b47-ec5f-9413-9993-xxxxxx
​
object
​
object

资源消耗统计。仅在 task_status 为 SUCCEEDED 时返回。