> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# HappyHorse 1.0

> Video model offering Text-to-Video, Image-to-Video, Reference-to-Video, and Video Edit modes with high-fidelity, motion-smooth output.

![HappyHorse 1.0](https://media.empiriolabs.ai/model-logos/happyhorse-1-0.png)

[Alibaba Cloud](/providers/alibaba) · Video Generation

`POST /v1/videos/generations`

Video model offering Text-to-Video, Image-to-Video, Reference-to-Video, and Video Edit modes with high-fidelity, motion-smooth output.

## At a glance

| Field               | Value                                      |
| ------------------- | ------------------------------------------ |
| Model id            | `happyhorse-1-0`                           |
| Model release date  | 2026-05-06                                 |
| Input modalities    | Text, Image, Video                         |
| Output modalities   | Video                                      |
| Context window      | -                                          |
| Weight precision    | -                                          |
| Region              | Singapore                                  |
| Features            | audio_sync, editing                        |
| Native inference    | No                                         |
| New                 | No                                         |
| Supported endpoints | `POST /v1/videos/generations`              |
| Alternate model ids | `alibaba/happyhorse-1.0`, `happyhorse-1.0` |

## Pricing

| Charge          | Spec       | Rate   |
| --------------- | ---------- | ------ |
| All Modes 720P  | per second | \$0.14 |
| All Modes 1080P | per second | \$0.24 |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/videos/generations \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "happyhorse-1-0", "prompt": "sunrise over the ocean", "duration": 6}'
```

## Parameters

| Parameter       | Type    | Required | Default   | Description                                                                                                                                                           |
| --------------- | ------- | -------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`        | string  | yes      | -         | Scene description.                                                                                                                                                    |
| `mode`          | enum    | no       | `"auto"`  | t2v: text-to-video. i2v: animate the attached image. videoedit: edit the attached video. r2v: reference-to-video. · Allowed: `auto`, `t2v`, `i2v`, `videoedit`, `r2v` |
| `resolution`    | enum    | no       | `"1080p"` | Output resolution. Larger = higher fidelity but slower / more expensive. · Allowed: `720p`, `1080p`                                                                   |
| `duration`      | number  | no       | `5`       | Clip length in seconds. Not used by video edit, which follows the input clip (up to 15 seconds). · Range: 3 – 15                                                      |
| `aspect_ratio`  | enum    | no       | `"16:9"`  | Output aspect ratio for text-to-video and reference-to-video. Image-to-video and video edit follow the input. · Allowed: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`          |
| `image`         | string  | no       | -         | Image URL. One for i2v, up to 9 for r2v, and up to 5 optional references for videoedit.                                                                               |
| `video`         | string  | no       | -         | Source video URL. Required for videoedit.                                                                                                                             |
| `seed`          | number  | no       | -         | Reproducibility seed.                                                                                                                                                 |
| `audio_setting` | enum    | no       | `"auto"`  | auto: generate native audio. origin: keep the audio of the source video (video edit only). · Allowed: `auto`, `origin`                                                |
| `watermark`     | boolean | no       | false     | Add a 'HappyHorse' watermark to the output.                                                                                                                           |

## Notes

**Modes** (in one model)

* Text-to-video
* Image-to-video
* Reference-to-video
* Video-to-video Edit (MP4/MOV/WEBM input)

**Constraints**

* 720p / 1080p, 3-15s per generation
* Edit duration matches the input video length

**Aspect ratios**

* Text modes: 16:9, 9:16, 1:1
* Reference mode adds: 4:3, 3:4

**Uploaded media preprocessing**

* Video inputs are capped to 15 seconds.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/happyhorse-1-0`.