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

> 通过 HappyHorse 1.1 生成文生视频、图生视频或参考图生视频任务。

HappyHorse 1.1 是阿里云百炼的视频生成模型系列。根据输入内容选择文生视频、单张首帧图生视频或多参考图生视频；三种工作流均通过 `POST /v1/video/generations` 创建异步任务。

<Note>
  `T2V` 表示文生视频，`I2V` 表示图生视频，`R2V` 表示参考图生视频。请保存返回的任务 ID，并通过[任务查询](/zh/guides/model-api/alibaba/happyhorse-task-query)轮询结果。
</Note>

## 核心能力

* **同步音频** - 三种 HappyHorse 1.1 工作流均生成带音频的 24 fps MP4 视频
* **分辨率** - `720P` 或 `1080P`
* **时长** - 3 至 15 秒之间的整数
* **随机种子与水印** - 可设置随机种子，并控制 HappyHorse 水印

<Tabs sync={false}>
  <Tab title="文生视频">
    使用 `happyhorse-1.1-t2v` 根据文本提示生成视频。

    ```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-t2v",
        "input": {"prompt": "夜晚，一座纸板搭建的微缩城市苏醒，小火车亮着灯缓缓驶过。"},
        "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false, "seed": 42}
      }'
    ```

    | 参数                      | 必填 | 说明                                                                    |
    | ----------------------- | -- | --------------------------------------------------------------------- |
    | `input.prompt`          | 是  | 文本描述，最多 5000 个非中文字符或 2500 个中文字符                                       |
    | `parameters.ratio`      | 否  | `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21` 或 `21:9`；默认 `16:9` |
    | `parameters.resolution` | 否  | `720P` 或 `1080P`；默认 `1080P`                                           |
  </Tab>

  <Tab title="图生视频">
    使用 `happyhorse-1.1-i2v`，并传入且仅传入一张 `first_frame` 首帧图片。支持公网 HTTP/HTTPS URL 或 Base64 Data URL；图片格式为 JPEG、JPG、PNG 或 WEBP，宽高均不低于 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>I2V 不支持 `parameters.ratio`；输出视频以首帧图片宽高比为基准。</Note>
  </Tab>

  <Tab title="参考图生视频">
    使用 `happyhorse-1.1-r2v`，并传入 1 至 9 张 `reference_image`。支持公网 URL 或 Base64 Data URL；图片格式为 JPEG、JPG、PNG 或 WEBP，短边不低于 400 像素，每张不超过 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>
  </Tab>
</Tabs>

## 通用参数

| 参数                     | 类型      | 说明                           |
| ---------------------- | ------- | ---------------------------- |
| `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">查看 HappyHorse 1.1 的三种请求格式。</Card>
  <Card title="任务查询" icon="magnifying-glass" href="/zh/guides/model-api/alibaba/happyhorse-task-query">轮询任务状态并获取结果链接。</Card>
</CardGroup>

## 官方参考

* [文生视频](https://help.aliyun.com/zh/model-studio/happyhorse-text-to-video-api-reference)
* [图生视频](https://help.aliyun.com/zh/model-studio/happyhorse-image-to-video-api-reference)
* [参考图生视频](https://help.aliyun.com/zh/model-studio/happyhorse-reference-to-video-api-reference)

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