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

> 通过 HappyHorse 1.1 T2V 根据文本生成带同步音频的视频。

HappyHorse 1.1 T2V 是阿里云百炼的文生视频模型。它通过 AnyFast 异步视频接口，根据文本提示生成带同步音频的 24 fps MP4 视频。

`T2V` 表示**文本生成视频**（Text-to-Video）：请求只需提供文本提示，无需输入图片。

## 核心能力

* **文生视频** - 根据文本描述生成视频和音频
* **分辨率** - `720P` 或 `1080P`
* **时长** - 3 至 15 秒之间的整数
* **宽高比** - `16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21` 或 `21:9`
* **随机种子** - 通过 `seed` 提高结果的可复现性
* **水印控制** - 控制是否添加 HappyHorse 水印

## 调用流程

```text theme={null}
1. POST /v1/video/generations -> task_id
2. GET /v1/video/generations/{task_id} -> 轮询至任务完成
3. 从返回的结果链接下载视频
```

<Note>
  视频生成采用异步任务。请保存返回的任务 ID 并轮询任务查询接口。任务 ID 和成功后的结果链接有效期均为 24 小时。
</Note>

## 快速示例

```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
    }
  }'
```

## 参数说明

| 参数                      | 类型      | 必填 | 说明                                       |
| ----------------------- | ------- | -- | ---------------------------------------- |
| `model`                 | string  | 是  | 必须为 `happyhorse-1.1-t2v`                 |
| `input.prompt`          | string  | 是  | 视频描述，最多 5000 个非中文字符或 2500 个中文字符，超出部分会被截断 |
| `parameters.resolution` | string  | 否  | `720P` 或 `1080P`，默认 `1080P`              |
| `parameters.ratio`      | string  | 否  | 输出宽高比，默认 `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-t2v">
    查看请求和响应字段。
  </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-text-to-video-api-reference)。

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