HappyHorse 1.0 R2V API

快马1.0 多图参考生视频, 最多9张参考图 → 主体一致性视频

模型名: happyhorse-1.0-r2v
厂商: HappyHorse
类型: video

POST /v1/videos/generations

多图参考生视频: 最多 9 张参考图, 主体一致性更好。

请求参数

参数	类型	必填	说明
`model`	string	是	要调用的模型名, 填模型广场里的名称。
`duration`	integer	是	视频时长(秒)。⚠️ 必须放在顶层, 并与 input/parameters 里的实际取值保持一致 —— 只写在嵌套结构里我们读不到。
`resolution`	string	是	分辨率, 取 480p / 720p / 1080p。⚠️ 同样必须放在顶层, 并与 parameters.size 保持一致。
`input`	object	是	生成入参对象, 按上游原生格式原样透传(不做字段改写)。各用法的必填项见下方 input.* 说明。
`parameters`	object	否	生成参数对象, 按上游原生格式原样透传。常用 size 指定像素尺寸: 480p→832480 · 720p→1280720 · 1080p→1920*1080。
`aspect_ratio`	string	否	宽高比, 如 16:9 / 9:16。
`wait`	boolean	否	true=阻塞等结果(最长 60s), false/省略=立即返回 task_id 后自行轮询(推荐)。
`callback_url`	string	否	任务终态后回调该地址。
`idempotency_key`	string	否	幂等键, 同一个键重复提交返回同一个任务, 不会重复计费。
`input.prompt`	string	是	提示词, 描述要生成的画面。
`input.ref_imgs`	array	是	参考图 URL 数组, 最多 9 张。
`input.function`	string	否	input.function 可省略 —— 省略时按模型名自动推断; 传了就按你传的走。
`parameters.size`	string	否	像素尺寸, 如 1280*720。与顶层 resolution 保持一致。

请求示例

curl https://api.router.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-r2v",
    "duration": 5,
    "resolution": "720p",
    "input": {
      "prompt": "保持人物一致，走在雨后的街道上",
      "ref_imgs": ["https://example.com/ref1.png",
                   "https://example.com/ref2.png"]
    },
    "parameters": {"size": "1280*720"}
  }'

接口通用说明: 提交视频任务