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

# HappyHorse 1.0

> 通过 HappyHorse 1.0 创建文生视频、图生视频、参考图生视频和视频编辑任务。

HappyHorse 1.0 是阿里云百炼的视频生成模型系列。四种能力共用 `POST /v1/video/generations` 创建端点，并通过不同的 AnyFast 模型 ID 选择工作流。

| 能力    | AnyFast 模型 ID               | 主要输入                   |
| ----- | --------------------------- | ---------------------- |
| 文生视频  | `happyhorse-1.0-t2v`        | 文本提示词                  |
| 图生视频  | `happyhorse-1.0-i2v`        | 1 张首帧图片，可选提示词          |
| 参考生视频 | `happyhorse-1.0-r2v`        | 文本提示词和 1–3 张参考图片       |
| 视频编辑  | `happyhorse-1.0-video-edit` | 编辑提示词、1 个视频和 0–5 张参考图片 |

<Note>
  创建接口立即返回任务 ID。使用 `GET /v1/video/generations/{task_id}` 轮询，直到 `data.status` 变为 `SUCCESS` 或 `FAILURE`。
</Note>

## 能力示例

以下素材来自阿里云官方文档，仅用于展示各工作流的输入形式，不代表通过 AnyFast 复现的输出结果。

<Tabs sync={false}>
  <Tab title="文生视频">
    只需描述主体、动作、场景、风格、镜头和声音。模型可输出带音频的 MP4 视频。
  </Tab>

  <Tab title="图生视频">
    首帧决定输出画面的构图和宽高比，提示词用于描述后续动作与镜头变化。

    <div className="max-w-3xl mx-auto">
      <Frame caption="阿里云官方首帧输入示例">
        <img src="https://cdn.translate.alibaba.com/r/wanx-demo-1.png" alt="HappyHorse 1.0 图生视频官方首帧示例" className="w-full aspect-video object-contain" />
      </Frame>
    </div>
  </Tab>

  <Tab title="参考生视频">
    参考图片用于保持人物、服饰和物件等视觉特征。AnyFast 当前节点支持 1–3 张参考图片。

    <Columns cols={2}>
      <Frame caption="人物参考">
        <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg" alt="HappyHorse 1.0 官方人物参考图" className="w-full aspect-video object-contain" />
      </Frame>

      <Frame caption="饰品参考">
        <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg" alt="HappyHorse 1.0 官方饰品参考图" className="w-full aspect-video object-contain" />
      </Frame>
    </Columns>
  </Tab>

  <Tab title="视频编辑">
    编辑已有视频中的人物、服饰、物件或场景。输入中必须且只能包含 1 个视频，还可增加 0–5 张参考图片。

    <Columns cols={2}>
      <Frame caption="阿里云官方输入视频">
        <video controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4">
          当前浏览器不支持视频播放。
        </video>
      </Frame>

      <Frame caption="阿里云官方服饰参考图">
        <img src="https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp" alt="HappyHorse 1.0 视频编辑官方服饰参考图" className="w-full aspect-video object-contain" />
      </Frame>
    </Columns>
  </Tab>
</Tabs>

## 创建任务

所有工作流都使用原生 `input` 和 `parameters` 结构。示例中的 `720P`、3 秒、极宽或极高比例、三张参考图以及视频编辑音频策略均已通过 AnyFast 国内节点验证。

<Tabs sync={false}>
  <Tab title="文生视频">
    ```bash cURL theme={null}
    curl --request POST \
      --url https://www.anyfast.com.cn/v1/video/generations \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "model": "happyhorse-1.0-t2v",
        "input": {
          "prompt": "夜色中的未来城市，镜头贴近地面快速向前推进"
        },
        "parameters": {
          "resolution": "720P",
          "ratio": "21:9",
          "duration": 3,
          "watermark": false,
          "seed": 0
        }
      }'
    ```
  </Tab>

  <Tab title="图生视频">
    图生视频只接受一个 `first_frame`。不支持 `ratio`；输出宽高比自动跟随首帧。

    ```bash cURL theme={null}
    curl --request POST \
      --url https://www.anyfast.com.cn/v1/video/generations \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "model": "happyhorse-1.0-i2v",
        "input": {
          "prompt": "镜头缓缓拉近，画面中的人物自然转头",
          "media": [
            {"type": "first_frame", "url": "https://example.com/first-frame.png"}
          ]
        },
        "parameters": {
          "resolution": "720P",
          "duration": 3,
          "watermark": false,
          "seed": 1
        }
      }'
    ```
  </Tab>

  <Tab title="参考生视频">
    ```bash cURL theme={null}
    curl --request POST \
      --url https://www.anyfast.com.cn/v1/video/generations \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "model": "happyhorse-1.0-r2v",
        "input": {
          "prompt": "让参考人物手持折扇走过灯火通明的长廊",
          "media": [
            {"type": "reference_image", "url": "https://example.com/person.jpg"},
            {"type": "reference_image", "url": "https://example.com/fan.jpg"},
            {"type": "reference_image", "url": "https://example.com/earrings.jpg"}
          ]
        },
        "parameters": {
          "resolution": "720P",
          "ratio": "9:21",
          "duration": 3,
          "watermark": false,
          "seed": 2
        }
      }'
    ```
  </Tab>

  <Tab title="视频编辑">
    `audio_setting: "origin"` 保留原视频音频，`auto` 让模型自动处理音频。不要传 `duration` 或 `ratio`。

    ```bash cURL theme={null}
    curl --request POST \
      --url https://www.anyfast.com.cn/v1/video/generations \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "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.webp"}
          ]
        },
        "parameters": {
          "resolution": "720P",
          "watermark": false,
          "audio_setting": "origin",
          "seed": 2147483647
        }
      }'
    ```
  </Tab>
</Tabs>

## 输出控制

| 参数              | 文生视频           | 图生视频           | 参考生视频          | 视频编辑            |
| --------------- | -------------- | -------------- | -------------- | --------------- |
| `resolution`    | `720P`、`1080P` | `720P`、`1080P` | `720P`、`1080P` | `720P`、`1080P`  |
| `ratio`         | 9 种固定比例        | 不支持，跟随首帧       | 9 种固定比例        | 不支持，跟随输入视频      |
| `duration`      | 3–15 秒         | 3–15 秒         | 3–15 秒         | 不支持自定义          |
| `watermark`     | 默认 `true`      | 默认 `true`      | 默认 `true`      | 默认 `true`       |
| `seed`          | 0–2147483647   | 0–2147483647   | 0–2147483647   | 0–2147483647    |
| `audio_setting` | 不支持            | 不支持            | 不支持            | `auto`、`origin` |

文生视频和参考生视频支持的 9 种比例为：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`4:5`、`5:4`、`9:21`、`21:9`。

<Warning>
  `seed` 超出 0–2147483647、时长小于 3 秒或大于 15 秒时，创建接口仍可能先返回任务 ID，随后任务异步失败。
</Warning>

## 输入要求

### 提示词

* 文生视频、参考生视频和视频编辑必须提供 `input.prompt`；图生视频可省略。
* 非中文提示词最多 5,000 个字符，中文提示词最多 2,500 个字符；超出部分由上游自动截断。

### 图生视频图片

* `input.media` 必须且只能包含 1 个 `first_frame`。
* 图片必须为公网可下载的 URL；输出比例跟随首帧，不要传 `ratio`。

### 参考生视频图片

* AnyFast 当前节点支持 1–3 个 `reference_image`；不支持 `reference_video`。
* 每张图片使用公网可下载的 URL。

### 视频编辑素材

* `input.media` 必须且只能包含 1 个 `video`，并可包含 0–5 个 `reference_image`。
* 视频：MP4 或 MOV，推荐 H.264；3–60 秒；长边不超过 4096 px、短边不低于 360 px；宽高比 1:2.5–2.5:1；不超过 100 MB；帧率高于 8 FPS。
* 参考图片：JPEG、JPG、PNG 或 WEBP；宽高均不低于 300 px；宽高比 1:2.5–2.5:1；单张不超过 20 MB。
* 输入视频不超过 15 秒时，输出时长大体跟随输入；超过 15 秒时，仅处理前 15 秒。

## 查询和保存结果

```bash cURL theme={null}
curl --request GET \
  --url https://www.anyfast.com.cn/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

轮询 `data.status`：`NOT_START`、`QUEUED` 和 `IN_PROGRESS` 时继续等待；`SUCCESS` 时读取 `data.result_url`；`FAILURE` 时读取 `data.fail_reason`。成功响应中的 `fail_reason` 也可能被兼容层填为结果 URL，因此必须以 `status` 判断任务是否成功。

结果 URL 通常只保留 24 小时，请及时下载或转存。

## 相关文档

* [HappyHorse 1.0 API 参考](/api-reference/model-api/alibaba/happyhorse-1.0)
* [阿里云模型能力与规格](https://www.alibabacloud.com/help/zh/model-studio/video-generate-edit-model)
* [阿里云文生视频 API](https://www.alibabacloud.com/help/zh/model-studio/happyhorse-text-to-video-api-reference)
* [阿里云图生视频 API](https://www.alibabacloud.com/help/zh/model-studio/happyhorse-image-to-video-api-reference)
* [阿里云视频编辑 API](https://www.alibabacloud.com/help/zh/model-studio/happyhorse-video-edit-api-reference)

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