Skip to main content
POST
HappyHorse 视频生成

简介

HappyHorse(快马)是阿里云百炼推出的视频生成系列,由文生视频(HappyHorse-T2V)、图生视频(HappyHorse-I2V)与参考生视频(HappyHorse-R2V)组成,主打物理真实、运动流畅的高质量视频输出。全系列支持 720P1080P 输出,时长 3–15 秒 通过 GravitexAI 统一视频接口调用:先 提交视频任务 获取 task_id,再 查询视频任务 轮询状态并获取 url
HappyHorse 的请求体通过 metadata.inputmetadata.parameters 传递底层 DashScope 参数,与万相 2.7 结构相同。参考生视频在 prompt 中使用 [Image 1][Image 2] 指代参考图(英文方括号格式),且仅支持图片参考,不支持视频参考。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

支持的模型

调用流程

  1. 提交任务POST /v1/video/generations,传入 modelpromptdurationmetadata 中的 HappyHorse 参数。
  2. 轮询状态GET /v1/video/generations/{task_id},建议每 3–15 秒查询一次,直到 statussucceededfailed
  3. 获取结果:成功时响应中的 url 为视频地址(有效期通常为 24 小时,请及时下载转存)。

通用请求结构

提交成功响应

查询成功响应

使用场景

基于文本提示词生成物理真实、运动流畅的视频。
string
必填
文本提示词,描述期望生成的视频内容
string
默认值:"1080P"
720P1080P
string
默认值:"16:9"
宽高比:16:99:161:14:33:44:55:49:2121:9
integer
默认值:"5"
视频时长(秒),取值范围 3–15
boolean
默认值:"true"
是否添加水印(右下角固定文案「Happy Horse」)
integer
随机种子,范围 [0, 2147483647],用于提升可复现性
文生视频示例:

参数参考

通用 parameters

文生视频 & 参考生视频

媒体输入限制

错误处理

任务失败时,statusfailederror.message 包含具体原因。

常见问题

视频 urltask_id 有效期通常为 24 小时。建议获取后立即下载并转存至自有存储。
在 prompt 中使用 [Image 1][Image 2] 等英文方括号格式,顺序与 media 数组中 reference_image 的顺序一致。需明确描述参考图中的具体对象。
HappyHorse 图生视频仅支持 首帧first_frame)模式,不支持首尾帧、视频续写或音频驱动。
结构相同,均使用 metadata.input / metadata.parametersmedia 数组。主要差异:HappyHorse 参考生视频使用 [Image n] 指代且仅支持图片(最多 9 张);万相 2.7 使用「图n / 视频n」并支持视频参考与音色复刻。HappyHorse 默认分辨率 1080P、默认添加水印,时长范围为 3–15 秒。

相关接口

提交视频任务

统一视频任务提交入口与多模型参数说明

查询视频任务

轮询任务状态并获取视频 URL