> ## 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 I2V

> 通过 HappyHorse 1.1 I2V 将首帧图片生成带同步音频的视频。

HappyHorse 1.1 I2V 将一张首帧图片生成带同步音频的 24 fps MP4 视频。文本提示用于描述首帧之后的动作和镜头变化。

`I2V` 表示**图片生成视频**（Image-to-Video）。该模型仅接收一张 `type: "first_frame"` 的首帧图片。

## 核心能力

* **首帧图生视频** - 让单张输入图片动起来
* **同步音频** - 随视频生成匹配的音频
* **分辨率** - `720P` 或 `1080P`
* **时长** - 3 至 15 秒之间的整数
* **保留画幅** - 输出视频大致沿用输入图片的宽高比

## 输入图片要求

* 格式：JPEG、JPG、PNG 或 WEBP
* 输入方式：公网 HTTP/HTTPS URL 或 Base64 Data URL
* 尺寸：宽和高均不得低于 300 像素
* 宽高比：1:2.5 至 2.5:1
* 文件大小：不超过 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-i2v",
    "input": {
      "prompt": "小猫从草地上快速跑过，镜头平稳跟随。",
      "media": [
        {
          "type": "first_frame",
          "url": "https://example.com/cat.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "watermark": false
    }
  }'
```

<Note>
  HappyHorse 1.1 I2V 不支持设置 `ratio`。输出会以首帧图片的宽高比为基准，并可能根据视频编码要求进行小幅调整。
</Note>

## 参数说明

| 参数                      | 类型      | 必填 | 说明                                 |
| ----------------------- | ------- | -- | ---------------------------------- |
| `model`                 | string  | 是  | 必须为 `happyhorse-1.1-i2v`           |
| `input.prompt`          | string  | 否  | 动作和镜头描述，最多 5000 个非中文字符或 2500 个中文字符 |
| `input.media`           | array   | 是  | 必须且只能包含一张首帧图片                      |
| `input.media[0].type`   | string  | 是  | 必须为 `first_frame`                  |
| `input.media[0].url`    | string  | 是  | 公网图片 URL 或 Base64 Data URL         |
| `parameters.resolution` | string  | 否  | `720P` 或 `1080P`，默认 `1080P`        |
| `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-i2v">
    查看请求和响应字段。
  </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-image-to-video-api-reference)。

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