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

# HappyHorse 1.0 R2V

> 阿里 DashScope HappyHorse 1.0 参考图生视频模型。基于 1-3 张参考图通过异步任务接口生成视频。

HappyHorse 1.0 R2V 基于 1-3 张参考图与文本提示生成视频。使用**异步任务接口**——提交任务后轮询直至完成。

## 核心能力

* **参考图生视频** — 使用 1-3 张图片作为视觉参考
* **分辨率** — 720P / 1080P
* **宽高比** — 16:9、9:16、1:1、4:3、3:4
* **时长** — 3-15 秒
* **水印控制** — 可选关闭右下角水印

## 工作流

```
1. POST /v1/video/generations  →  task_id
2. GET  /v1/video/generations/{task_id}  →  轮询直至 SUCCESS / FAILURE
3. 读取 data.result_url  （有效期 24 小时）
```

## 快速示例

```bash cURL theme={null}
curl https://dayu.cdn-fly.com/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",
      "https://example.com/ref3.jpg"
    ],
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false
    }
  }'
```

```python Python theme={null}
import requests, time

headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.post(
    "https://dayu.cdn-fly.com/v1/video/generations",
    headers=headers,
    json={
        "model": "happyhorse-1.0-r2v",
        "prompt": "身着红色旗袍的女性轻抬玉手展开折扇",
        "images": [
            "https://example.com/ref1.jpg",
            "https://example.com/ref2.jpg",
            "https://example.com/ref3.jpg",
        ],
        "parameters": {
            "resolution": "720P",
            "ratio": "16:9",
            "duration": 5,
            "watermark": False,
        }
    }
)
task_id = resp.json()["task_id"]
```

## 参数说明

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `model` | string | 是 | 必须为 `happyhorse-1.0-r2v` |
| `prompt` | string | 是 | 视频描述文本 |
| `images` | string\[] | 是 | 1-3 张参考图 URL |
| `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 | 否 | 默认 `true`，设为 `false` 关闭水印 |
| `seed` | integer | 否 | 随机种子 `[0, 2147483647]` |

## 计费

按 **分辨率档位 × 用户请求时长** 计费，预扣金额即最终金额。失败任务自动退费。

> **[API 参考](/zh/api-reference/model-api/alibaba/happyhorse-1.0-r2v)**
>
> HappyHorse 1.0 R2V 交互式 Playground。

> **[任务查询](/zh/guides/model-api/alibaba/happyhorse-task-query)**
>
> 轮询任务状态并获取最终视频 URL。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.