> ## 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.0
> 通过 HappyHorse 1.0 创建文生视频、图生视频、参考图生视频或视频编辑任务。
HappyHorse 1.0 是阿里云百炼的异步视频生成模型系列。本页汇总其文生视频、图生视频、参考图生视频和视频编辑工作流。
`T2V` 表示文生视频，`I2V` 表示图生视频，`R2V` 表示参考图生视频。通过 `POST /v1/video/generations` 创建任务后，使用返回的任务 ID 按[任务查询](/zh/guides/model-api/alibaba/happyhorse-task-query)轮询结果。
## 核心能力
* **异步生成** - 创建任务后轮询，直至状态变为 `SUCCESS` 或 `FAILURE`
* **分辨率** - `720P` 或 `1080P`
* **时长** - 3 至 15 秒
* **输出控制** - 可按工作流设置比例、水印和随机种子
使用 `happyhorse-1.0-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.0-t2v",
"prompt": "一只猫在草地上奔跑",
"parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}'
```
使用 `happyhorse-1.0-i2v` 并传入一张首帧图片。`image` 接收单张 URL；也支持 `images` 数组，但只会使用其中第一张作为首帧。
```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.0-i2v",
"prompt": "镜头缓缓拉近，画面逐渐动起来",
"image": "https://example.com/first-frame.png",
"parameters": {"resolution": "720P", "duration": 5, "watermark": false}
}'
```
使用 `happyhorse-1.0-r2v` 并传入 1 至 3 张参考图 URL。
```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.0-r2v",
"prompt": "身着红色旗袍的女性轻抬玉手展开折扇",
"images": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"],
"parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
}'
```
使用 `happyhorse-1.0-video-edit`，通过文字指令编辑已有视频，并可选传入参考图。必须使用原生 `input.media` 结构：包含且仅包含一条 `video`，可选添加 0 至 5 张 `reference_image`。
```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.0-video-edit",
"input": {
"prompt": "让视频中的角色穿上图片中的条纹毛衣。",
"media": [
{"type": "video", "url": "https://example.com/source.mp4"},
{"type": "reference_image", "url": "https://example.com/sweater.png"}
]
},
"parameters": {"resolution": "720P", "watermark": false}
}'
```
原始视频必须为公网可访问 URL。输出时长由输入视频决定，`duration` 对视频编辑可能不生效。
## 参数说明
可选控制参数既可以放在顶层，也可以放进 `parameters`；两种写法均可使用。
| 参数 | 类型 | 必填 | 说明 |
| ------------- | --------- | ---- | -------------------------------------------------------------------------------------------- |
| `model` | string | 是 | `happyhorse-1.0-t2v`、`happyhorse-1.0-i2v`、`happyhorse-1.0-r2v` 或 `happyhorse-1.0-video-edit` |
| `prompt` | string | 是 | 视频内容描述 |
| `image` | string | I2V | 单张首帧图片 URL |
| `images` | string\[] | R2V | 1 至 3 张参考图 URL；I2V 支持数组形式但只使用第一张 |
| `resolution` | string | 否 | `720P` 或 `1080P`；默认 `1080P` |
| `ratio` | string | 否 | `16:9`、`9:16`、`1:1`、`4:3` 或 `3:4`；默认 `16:9` |
| `duration` | integer | 否 | 3 至 15 秒；默认 `5` |
| `watermark` | boolean | 否 | 是否添加 HappyHorse 水印；默认 `true` |
| `seed` | integer | 否 | `[0, 2147483647]` 范围内的随机种子 |
| `input.media` | object\[] | 视频编辑 | 有且仅有一条 `video`，可选包含 0 至 5 张 `reference_image` |
查看 HappyHorse 1.0 的四种请求格式。
轮询任务状态并获取结果链接。