HappyHorse API 调用说明

接口

创建视频任务

查询任务结果

支持模型

模型	场景
`happyhorse-1.0-t2v`	文生视频
`happyhorse-1.0-i2v`	图生视频，使用首帧图片生成视频
`happyhorse-1.0-r2v`	参考生视频，支持 1 到 9 张参考图片
`happyhorse-1.0-video-edit`	视频编辑，支持输入视频和可选参考图片

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称。可选值见“支持模型”。
`prompt`	string	是	文本提示词，用于描述期望生成或编辑的视频内容。
`image`	string	否	单张图片 URL 或 Base64。适用于图生视频。
`images`	string[]	否	多张图片 URL 或 Base64。适用于参考生视频。
`input_reference`	string	否	单个输入素材 URL。适用于图生视频，可作为 `image` 的替代写法。
`resolution`	string	否	输出分辨率档位。可选值：`720P`、`1080P`。默认值：`1080P`。
`ratio`	string	否	输出宽高比。可选值：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21`、`21:9`。默认值：`16:9`。
`duration`	integer	否	输出时长，单位秒。取值范围：`3` 到 `15`。默认值：`5`。
`metadata`	object	否	高级参数。用于传入媒体素材、随机种子、水印、声音等参数。

metadata 参数

`metadata.input.media`

用于传入多个媒体素材。数组元素按顺序对应提示词中的素材指代。

字段	类型	必填	说明
`type`	string	是	媒体类型。常用值：`first_frame`、`last_frame`、`reference_image`、`video`。
`url`	string	是	素材 URL 或 Base64。

常用媒体类型：

类型	说明
`first_frame`	首帧图片。适用于图生视频。
`last_frame`	尾帧图片。适用于首尾帧过渡类视频。
`reference_image`	参考图片。适用于参考生视频和视频编辑。
`video`	待编辑视频。适用于视频编辑。

`metadata.parameters`

参数	类型	说明
`resolution`	string	输出分辨率档位：`720P`、`1080P`。
`ratio`	string	输出宽高比。
`duration`	integer	输出时长，单位秒。
`watermark`	boolean	是否添加 “Happy Horse” 水印。
`seed`	integer	随机种子，取值范围：`0` 到 `2147483647`。
`audio_setting`	string	视频编辑声音控制。可选值：`auto`、`origin`。

调用示例

文生视频

图生视频

也可以使用 metadata.input.media 指定首帧：

{
  "model": "happyhorse-1.0-i2v",
  "prompt": "一只猫在草地上奔跑，镜头平稳跟拍，动作自然流畅",
  "metadata": {
    "input": {
      "media": [
        {
          "type": "first_frame",
          "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5
    }
  }
}

参考生视频

使用 metadata.input.media 指定参考图：

{
    "model": "happyhorse-1.0-r2v",
    "prompt": "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。",
    "metadata": {
        "input": {
            "media": [
                {
                    "type": "reference_image",
                    "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg"
                },
                {
                    "type": "reference_image",
                    "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg"
                },
                {
                    "type": "reference_image",
                    "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
                }
            ]
        },
        "parameters": {
            "resolution": "720P",
            "ratio": "16:9",
            "duration": 5
        }
    }
}

视频编辑

查询任务

任务状态：

状态	说明
`queued`	排队中
`in_progress`	生成中
`completed`	已完成
`failed`	失败

查询成功后，可从响应中的视频地址字段获取生成结果。视频地址通常有有效期，建议及时下载或转存。

素材限制

场景	限制
图片素材	支持 JPEG、JPG、PNG、WEBP；单个文件不超过 20 MB。
图生视频	建议图片短边不低于 400 像素，画面清晰。
参考生视频	支持 1 到 9 张参考图片。
视频编辑输入视频	支持 MP4、MOV；建议 H.264 编码；时长 3 到 60 秒；文件不超过 100 MB。
视频编辑参考图片	支持 0 到 5 张参考图片。

HappyHorse参数说明

HappyHorse API 调用说明#

接口#

创建视频任务#

查询任务结果#

支持模型#

请求参数#

metadata 参数#

metadata.input.media#

metadata.parameters#

调用示例#

文生视频#

图生视频#

参考生视频#

视频编辑#

查询任务#

素材限制#

HappyHorse API 调用说明

接口

创建视频任务

查询任务结果

支持模型

请求参数

metadata 参数

`metadata.input.media`

`metadata.parameters`

调用示例

文生视频

图生视频

参考生视频

视频编辑

查询任务

素材限制