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

# HappyHorse 1.1

> Video generation with text-to-video, image-to-video, and reference-to-video modes

Generate videos using HappyHorse 1.1 with three modes: text-to-video, image-to-video (first frame), and reference-to-video (character consistency using reference images).

## Model

```
alibaba/happyhorse-1.1-video
```

## Modes

| Mode  | Description                                                                                                              |
| ----- | ------------------------------------------------------------------------------------------------------------------------ |
| `t2v` | Generate video from a text prompt                                                                                        |
| `i2v` | Generate video from a first frame image                                                                                  |
| `r2v` | Generate video from reference images. Use `[Image N]` in prompt to reference them (order matches `reference_image_urls`) |

## Parameters

| Parameter              | Type      | Required | Default   | Description                                                                                                      |
| ---------------------- | --------- | -------- | --------- | ---------------------------------------------------------------------------------------------------------------- |
| `mode`                 | string    | No       | `"t2v"`   | `"t2v"`, `"i2v"`, or `"r2v"`                                                                                     |
| `prompt`               | string    | No       | `""`      | Text prompt describing the desired video                                                                         |
| `first_frame_url`      | string    | No       | `null`    | URL of the first frame image for I2V mode                                                                        |
| `reference_image_urls` | string\[] | No       | `null`    | Reference image URLs for R2V mode (1-9). Use `[Image N]` in prompt to reference them                             |
| `ratio`                | string    | No       | `null`    | Aspect ratio (T2V/R2V only): `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`, `"4:5"`, `"5:4"`, `"9:21"`, `"21:9"` |
| `resolution`           | string    | No       | `"1080P"` | `"720P"` or `"1080P"`                                                                                            |
| `duration`             | integer   | No       | `5`       | Output duration in seconds (3-15)                                                                                |
| `watermark`            | boolean   | No       | `false`   | Add watermark to the output                                                                                      |
| `seed`                 | integer   | No       | `null`    | Random seed for reproducible generation (0-2147483647)                                                           |

## Example - Text-to-Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.1-video",
    "input": {
      "mode": "t2v",
      "prompt": "A golden retriever running through a field of wildflowers at sunset",
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 5
    }
  }'
```

## Example - Image-to-Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.1-video",
    "input": {
      "mode": "i2v",
      "prompt": "The camera slowly zooms out as the scene comes to life",
      "first_frame_url": "https://example.com/landscape.png",
      "resolution": "1080P",
      "duration": 10
    }
  }'
```

## Example - Reference-to-Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.1-video",
    "input": {
      "mode": "r2v",
      "prompt": "[Image 1] walks confidently through a busy city street",
      "reference_image_urls": ["https://example.com/person.png"],
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 8
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```