> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HappyHorse 1.1 R2V

> 通过 HappyHorse 1.1 R2V 根据最多九张参考图生成主体一致的视频。

HappyHorse 1.1 R2V 根据文本提示和 1 至 9 张参考图生成带同步音频的视频。适合需要在多个镜头中保持人物、商品、场景或视觉细节一致的任务。

`R2V` 表示**参考图生成视频**（Reference-to-Video）。参考图用于约束主体和外观，不会被视为视频首帧。

## 核心能力

* **多图参考** - 支持输入 1 至 9 张图片
* **图片指代** - 在提示词中使用 `[Image 1]`、`[Image 2]` 等标识引用图片
* **同步音频** - 随视频生成匹配的音频
* **分辨率** - `720P` 或 `1080P`
* **时长** - 3 至 15 秒之间的整数
* **宽高比控制** - 支持横屏、竖屏、方形及超宽画幅

## 参考图片要求

* 格式：JPEG、JPG、PNG 或 WEBP
* 输入方式：公网 HTTP/HTTPS URL 或 Base64 Data URL
* 数量：1 至 9 张
* 分辨率：短边不低于 400 像素，建议使用 720P 或更清晰的图片
* 文件大小：每张不超过 20 MB

## 快速示例

```bash cURL theme={null}
curl https://www.anyfast.ai/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "input": {
      "prompt": "[Image 1]中身穿红色旗袍的女性走进房间，展开[Image 2]中的折扇，镜头随后推近至面部特写。",
      "media": [
        {
          "type": "reference_image",
          "url": "https://example.com/person.jpg"
        },
        {
          "type": "reference_image",
          "url": "https://example.com/fan.jpg"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false
    }
  }'
```

<Tip>
  `input.media` 的顺序决定图片编号：第一项对应 `[Image 1]`，第二项对应 `[Image 2]`，依此类推。引用图片时应同时说明图片中的具体人物或物体。
</Tip>

## 参数说明

| 参数                      | 类型      | 必填 | 说明                                                                    |
| ----------------------- | ------- | -- | --------------------------------------------------------------------- |
| `model`                 | string  | 是  | 必须为 `happyhorse-1.1-r2v`                                              |
| `input.prompt`          | string  | 是  | 视频描述，可使用 `[Image N]` 引用参考图；最多 5000 个非中文字符或 2500 个中文字符                 |
| `input.media`           | array   | 是  | 包含 1 至 9 个参考图片对象                                                      |
| `input.media[].type`    | string  | 是  | 必须为 `reference_image`                                                 |
| `input.media[].url`     | string  | 是  | 公网图片 URL 或 Base64 Data URL                                            |
| `parameters.resolution` | string  | 否  | `720P` 或 `1080P`，默认 `1080P`                                           |
| `parameters.ratio`      | string  | 否  | `16:9`、`9:16`、`3:4`、`4:3`、`4:5`、`5:4`、`1:1`、`9:21` 或 `21:9`，默认 `16:9` |
| `parameters.duration`   | integer | 否  | 视频时长，范围为 3 至 15 秒，默认 `5`                                              |
| `parameters.watermark`  | boolean | 否  | 是否添加 HappyHorse 水印，默认 `true`                                          |
| `parameters.seed`       | integer | 否  | 随机种子，范围为 `[0, 2147483647]`                                            |

<CardGroup cols={2}>
  <Card title="API 参考" icon="code" href="/zh/api-reference/model-api/alibaba/happyhorse-1.1-r2v">
    查看请求和响应字段。
  </Card>

  <Card title="任务查询" icon="magnifying-glass" href="/zh/guides/model-api/alibaba/happyhorse-task-query">
    轮询任务状态并获取结果链接。
  </Card>
</CardGroup>

## 官方参考

参阅[阿里云百炼 HappyHorse 参考生视频 API 参考](https://help.aliyun.com/zh/model-studio/happyhorse-reference-to-video-api-reference)。

<script src="/feedback.js" />