HappyHorse 视频生成
视频系列
HappyHorse 视频生成
阿里 HappyHorse 文生视频、图生视频、参考生视频
POST
HappyHorse 视频生成
简介
HappyHorse(快马)是阿里云百炼推出的视频生成系列,由文生视频(HappyHorse-T2V)、图生视频(HappyHorse-I2V)与参考生视频(HappyHorse-R2V)组成,主打物理真实、运动流畅的高质量视频输出。全系列支持 720P 与 1080P 输出,时长 3–15 秒。 通过 GravitexAI 统一视频接口调用:先 提交视频任务 获取task_id,再 查询视频任务 轮询状态并获取 url。
HappyHorse 的请求体通过
metadata.input 与 metadata.parameters 传递底层 DashScope 参数,与万相 2.7 结构相同。参考生视频在 prompt 中使用 [Image 1]、[Image 2] 指代参考图(英文方括号格式),且仅支持图片参考,不支持视频参考。认证
string
必填
Bearer Token,如
Bearer sk-xxxxxxxxxx支持的模型
调用流程
- 提交任务:
POST /v1/video/generations,传入model、prompt、duration及metadata中的 HappyHorse 参数。 - 轮询状态:
GET /v1/video/generations/{task_id},建议每 3–15 秒查询一次,直到status为succeeded或failed。 - 获取结果:成功时响应中的
url为视频地址(有效期通常为 24 小时,请及时下载转存)。
通用请求结构
提交成功响应
查询成功响应
使用场景
- 文生视频 (T2V)
- 图生视频 (I2V)
- 参考生视频 (R2V)
参数参考
通用 parameters
文生视频 & 参考生视频
媒体输入限制
错误处理
任务失败时,
status 为 failed,error.message 包含具体原因。
常见问题
生成的视频链接有效期多久?
生成的视频链接有效期多久?
视频
url 与 task_id 有效期通常为 24 小时。建议获取后立即下载并转存至自有存储。参考生视频如何指代参考图?
参考生视频如何指代参考图?
在 prompt 中使用
[Image 1]、[Image 2] 等英文方括号格式,顺序与 media 数组中 reference_image 的顺序一致。需明确描述参考图中的具体对象。图生视频支持哪些模式?
图生视频支持哪些模式?
HappyHorse 图生视频仅支持 首帧(
first_frame)模式,不支持首尾帧、视频续写或音频驱动。与万相 2.7 的调用方式有何不同?
与万相 2.7 的调用方式有何不同?
结构相同,均使用
metadata.input / metadata.parameters 与 media 数组。主要差异:HappyHorse 参考生视频使用 [Image n] 指代且仅支持图片(最多 9 张);万相 2.7 使用「图n / 视频n」并支持视频参考与音色复刻。HappyHorse 默认分辨率 1080P、默认添加水印,时长范围为 3–15 秒。相关接口
提交视频任务
统一视频任务提交入口与多模型参数说明
查询视频任务
轮询任务状态并获取视频 URL
