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

# HappyHorse-1.1

HappyHorse 1.1 支持文生视频、首帧生视频和参考生视频，具备高度还原的动态画面生成能力，能够精准理解文本语义，输出流畅自然、细节丰富的高质量视频。

### 模型参数

* 模型ID：`happyhorse-1.1-t2v`/`happyhorse-1.1-i2v`/`happyhorse-1.1-r2v`
* 模型价格：你可以在[模型广场](https://geekai.co/models?platform=dashscope\&type=video)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations)
* API认证：[获取 API KEY](https://docs.geekai.co/cn/docs/quick_start)

<Note>
  不支持视频 API 中的以下参数：

  * `with_audio`
  * `size`
  * `quality`
  * `fps`
  * `audio`

  附：[快乐马 vs. 万相2.7模型选择文档](https://bailian.console.aliyun.com/cn-beijing?spm=5176.29619931.J__Z58Z6CX7MY__Ll8p1ZOR.1.74cd59fcEkLe98\&tab=doc#/doc/?type=model\&url=3026921)
</Note>

HappyHorse 1.1 宽高比 `aspect_ratio` 参数支持以下取值：

* `1:1`
* `16:9`
* `9:16`
* `4:3`
* `3:4`
* `4:5`
* `5:4`
* `9:21`
* `21:9`

HappyHorse 1.1 支持的输出视频分辨率 `resolution` 值如下：

* `720P`
* `1080P`（默认值）

<Note>
  注意： 在使用 `resolution` 参数时，请确保分辨率中的P需要大写，如：`720P`，`1080P`（默认值）。
</Note>

HappyHorse 1.1 支持的 `duration` 输出视频时长为 `3`-`15` 秒，默认值为 `5` 秒。

### 模型价格

HappyHorse 1.1 的价格按照生成视频的分辨率、时长来计算，以下是价格速算表：

| 模型                   | 分辨率   | 价格（单位：元/秒） |
| -------------------- | ----- | ---------- |
| `happyhorse-1.1-t2v` | 720P  | 0.9        |
| `happyhorse-1.1-i2v` | 720P  | 0.9        |
| `happyhorse-1.1-r2v` | 720P  | 0.9        |
| `happyhorse-1.1-t2v` | 1080P | 1.2        |
| `happyhorse-1.1-i2v` | 1080P | 1.2        |
| `happyhorse-1.1-r2v` | 1080P | 1.2        |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用速度优先渠道为例，折扣值是 `0.8`，那么生成 5 秒 720p 标准视频价格是 `0.9x5x0.8=3.6` 元，其他参数依次类推。

### 文生视频

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "一段紧张刺激的侦探追查故事，展现电影级叙事能力。第1个镜头[0-3秒] 全景：雨夜的纽约街头，霓虹灯闪烁，一位身穿黑色风衣的侦探快步行走。 第2个镜头[3-6秒] 中景：侦探进入一栋老旧建筑，雨水打湿了他的外套，门在他身后缓缓关闭。 第3个镜头[6-9秒] 特写：侦探的眼神坚毅专注，远处传来警笛声，他微微皱眉思考。 第4个镜头[9-12秒] 中景：侦探在昏暗走廊中小心前行，手电筒照亮前方。 第5个镜头[12-15秒] 特写：侦探发现关键线索，脸上露出恍然大悟的表情。",
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "async": true
}'
```

### 图生视频

**基于首帧**

传入图片到 `image` 字段即可实现基于首帧生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "一幅都市奇幻艺术的场景。一个充满动感的涂鸦艺术角色。一个由喷漆所画成的少年，正从一面混凝土墙上活过来。他一边用极快的语速演唱一首英文rap，一边摆着一个经典的、充满活力的说唱歌手姿势。场景设定在夜晚一个充满都市感的铁路桥下。灯光来自一盏孤零零的街灯，营造出电影般的氛围，充满高能量和惊人的细节。视频的音频部分完全由rap构成，没有其他对话或杂音。",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png",
    "async": true
}'
```

<Note>
  HappyHorse 1.1 目前仅支持首帧生视频，不支持首尾帧生视频。
</Note>

### 参考生视频

**参考图**

通过 `images` 传入一张或多张图（支持1-9张）即可实现基于参考图生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "@图1戴着眼镜穿着蓝色T恤的男生和@图2的柯基小狗，坐在@图3的草坪上，3D卡通风格",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ],
    "async": true
}'
```

<Note>
  HappyHorse 1.1 参考生视频目前仅支持基于参考图片生成视频，不支持音视频参数。
</Note>

### 异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的通用异步方式生成视频。

[视频 API](https://docs.geekai.co/cn/api/video/generations) 中的 `async` 参数用于控制是否异步生成视频，默认为 `false`，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 `true`，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。

具体操作请参考[Sora-2示例](https://docs.geekai.co/cn/docs/video/openai/sora-2#异步任务)，流程完全一样。