HappyHorse 视频生成

HappyHorse 使用统一任务接口 POST /v1/video/generations。提交成功后保存返回的 task_ ID，并按异步任务工作流查询结果。实际可用模型以列出模型返回的结果为准。

模型与输入

模型	能力	必需媒体	注意事项
`happyhorse-1.0-t2v`、`happyhorse-1.1-t2v`	文生视频	无	不能发送任何媒体。
`happyhorse-1.0-i2v`、`happyhorse-1.1-i2v`	首帧图生视频	1 张首帧图	图像比例决定输出比例，不能传 `ratio`。
`happyhorse-1.0-r2v`、`happyhorse-1.1-r2v`	参考图生视频	1–9 张参考图	在提示词中用 `[Image 1]`、`[Image 2]` 指代图片顺序。
`happyhorse-1.0-video-edit`	视频编辑	1 段视频	可选附加最多 5 张参考图。输出时长由源视频决定。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	`application/json`。

请求体字段

字段	类型	必填	说明
`model`	string	是	HappyHorse 模型 ID。
`prompt`	string	是	文本提示词。参考图模式可用 `[Image N]` 指代第 N 张参考图。
`size`	string	否	输出分辨率：`720P` 或 `1080P`。这是 AionRouter 对外字段。
`duration`	integer	条件必填	文生、图生和参考图生使用，范围为 3–15 秒。视频编辑不得传此字段。
`image`	string	图生时必填	首帧图片 URL。也可使用 `images` 或 `input_reference`。
`images`	string[]	图生或编辑时可选	图生时只保留一张首帧；编辑时作为可选参考图。
`input_reference`	string	图生或编辑时可选	图生时为首帧图片；编辑时为源视频 URL。
`metadata`	object	否	传递上游参数和结构化媒体输入。画幅、随机种子等必须放在 `metadata.parameters`。

`metadata.input.media[]` 元素

字段	类型	必填	说明
`type`	string	是	`first_frame`、`reference_image` 或 `video`。使用哪个值取决于模型能力。
`url`	string	是	媒体的公开可访问 URL。

happyhorse-*-i2v 只接受一个 first_frame。happyhorse-*-r2v 只接受 1–9 个 reference_image。happyhorse-*-video-edit 需要一个 video，可额外传最多 5 个 reference_image。

常用参数

字段	说明
`model`	使用上表中的模型 ID。
`prompt`	描述主体、动作、场景和镜头。参考图模式应显式写出图片序号。
`size`	使用 `720P` 或 `1080P`。AionRouter 将它映射为 HappyHorse 的分辨率参数。
`duration`	文生、图生和参考生支持 3–15 秒。视频编辑不传此字段。
`metadata.parameters.ratio`	文生和参考生可用：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21` 或 `21:9`。
`metadata.parameters.seed`	可选随机种子。
`metadata.parameters.watermark`	可选布尔值，用于控制水印。

文生视频示例

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "A cinematic view of a lantern floating across a night river",
    "duration": 5,
    "size": "720P",
    "metadata": {
      "parameters": { "ratio": "16:9", "seed": 42 }
    }
  }'

完整调用示例

所有示例均使用 POST /v1/video/generations。提交成功后，从响应的 id 保存公开 task_ ID；提交响应、查询响应和下载步骤见异步任务工作流。

首帧图生视频

happyhorse-*-i2v 必须只有一张首帧图。你可以使用 image、单个 images 项或 input_reference；以下示例使用 image。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "人物抬头微笑，窗外的树影轻轻摇曳，镜头缓慢推近",
    "image": "https://example.com/first-frame.jpg",
    "size": "720P",
    "duration": 5
  }'

输入图片的画幅决定输出比例。因此 happyhorse-*-i2v 不要传 metadata.parameters.ratio。

多图参考生视频

happyhorse-*-r2v 使用 metadata.input.media 传 1–9 张参考图。提示词中使用 [Image 1]、[Image 2] 指代数组顺序。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "让 [Image 1] 中的角色穿着 [Image 2] 的服装，在夜市中自然行走",
    "size": "720P",
    "duration": 5,
    "metadata": {
      "parameters": { "ratio": "9:16" },
      "input": {
        "media": [
          { "type": "reference_image", "url": "https://example.com/character.jpg" },
          { "type": "reference_image", "url": "https://example.com/outfit.jpg" }
        ]
      }
    }
  }'

视频编辑

视频编辑用 input_reference 传 1 段源视频。可以用 images 添加最多 5 张参考图；不要传 duration 或 metadata.parameters.ratio。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "prompt": "将画面改为温暖的胶片风格，保留人物动作和镜头节奏",
    "input_reference": "https://example.com/source-video.mp4",
    "images": ["https://example.com/style-reference.jpg"],
    "size": "720P"
  }'

不要混用能力：文生视频不能带媒体；图生只接受 1 张首帧；参考生只接受参考图；视频编辑必须恰好包含 1 段视频。视频编辑不得传 duration 或 metadata.parameters.ratio。

提交后按异步任务工作流查询和下载结果。

​模型与输入

​请求头

​请求体字段

​metadata.input.media[] 元素

​常用参数

​文生视频示例

​完整调用示例

​首帧图生视频

​多图参考生视频

​视频编辑

模型与输入

请求头

请求体字段

`metadata.input.media[]` 元素

常用参数

文生视频示例

完整调用示例

首帧图生视频

多图参考生视频

视频编辑