Skip to main content
POST
HappyHorse 1.1 视频生成
  • 对外模型固定为 happyhorse-1.1
  • 通过 action 区分文生视频、首帧图生视频、参考图生视频和视频编辑
  • 未传 action 时,存在首帧图会自动按图生视频处理,否则按文生视频处理
  • 异步任务管理,通过任务 ID 查询结果

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证。

Body

string
默认值:"happyhorse-1.1"
必填
视频生成模型名称,固定为 happyhorse-1.1
string
默认值:"text-to-video"
生成模式。可选项:
  • text-to-video - 文生视频
  • image-to-video - 首帧图生视频
  • reference-to-video - 参考图生视频
  • video-edit - 视频编辑
如果省略该字段,服务端会根据是否传入首帧图自动判断。
string
视频内容描述。文生视频、参考图生视频和视频编辑必填。首帧图生视频可选,但建议填写以控制画面运动和风格。
string[]
图生视频首帧图片 URL。仅使用第一张图片。也可以使用兼容字段 input_referenceimagesimageimage_with_roles[{ role: "first_frame" }]图片要求:
  • 格式:JPEGJPGPNGBMPWEBP
  • 文件大小:不超过 10MB
  • 宽高:不小于 300px
  • 宽高比:1:2.52.5:1
string[]
参考图片 URL 列表。reference-to-video 必填,支持 19 张;video-edit 可选,最多 5 张。
string
视频编辑的输入视频 URL。action=video-edit 时必填。
string
默认值:"auto"
视频编辑的声音控制。仅 action=video-edit 有效。可选项:
  • auto
  • origin
integer
默认值:5
视频时长,单位秒。可选范围:315
string
默认值:"1080P"
视频分辨率。可选项:
  • 720P
  • 1080P
string
默认值:"16:9"
文生视频宽高比。图生视频会根据首帧图决定画幅。可选项:
  • 16:9
  • 9:16
  • 1:1
  • 4:3
  • 3:4
也可以使用兼容字段 size
integer
随机种子,用于控制生成结果的确定性。
boolean
默认值:true
是否添加水印。

文生视频示例

图生视频示例

参考图生视频示例

视频编辑示例

查询任务

提交接口会返回任务 ID。使用通用视频任务查询接口获取状态和结果:

渠道配置

HappyHorse 使用 DashScope API Key。默认上游地址为 https://dashscope.aliyuncs.com 如需使用国际站,在管理后台将该渠道的 Base URL 覆盖为: