跳转到主要内容
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": "8ae698ba-df2d-966c-abcf-xxxxxx",
  "output": {
    "task_id": "e56d806f-76f9-4037-aefa-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-20 19:33:50.425",
    "scheduled_time": "2026-04-20 19:33:50.463",
    "end_time": "2026-04-20 19:35:34.216",
    "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
  }
}
轮询任务状态,任务成功后下载视频。

轮询策略

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

鉴权

string
header
必填

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

路径参数

string
必填

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

响应

200-application/json
string

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

8ae698ba-df2d-966c-abcf-xxxxxx
object
object

资源消耗统计。仅在 task_statusSUCCEEDED 时返回。