# Happy Horse

Ranked first on the public video leaderboard by blind human votes. Picture and sound made together, and 1080p in about forty seconds.

Model id: `happy-horse`
Type: Video
Inputs: Text, References
Length: 3 to 15 s
Resolution: 720p, 1080p
Aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4
Updated: Oct 12, 2026

## Pricing

| Setting | MiniAPI | fal | Difference |
| --- | ---: | ---: | ---: |
| 720p | $0.154 / s | $0.14 | +10% |
| 1080p | $0.22 / s | $0.28 | -21% |

You are not charged for a job that fails.

## Parameters

| Name | Required | Values | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` | Yes | text |  | What to make, in plain words. |
| `image_urls` | For references | https URLs |  | Pictures to use as references. Only with references. |
| `aspect_ratio` | No | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 | Shape of the result, for example 16:9 or 9:16. |
| `resolution` | No | 720p, 1080p | 1080p | Output size. Higher is sharper, slower and costs more. |
| `duration` | No | 3 to 15 | 5 | Length in seconds. The price changes with it. |
| `seed` | No | integer |  | The same seed with the same settings gives a similar result. Leave it out for a random one. |

## Quickstart

```bash
curl -X POST "https://api.minicut.ai/v1/queue/happy-horse" \
  -H "Authorization: Key $MINIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a red fox runs through snow at dawn","resolution":"1080p","duration":5}'
```

```json
{
  "request_id": "0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "status": "IN_QUEUE",
  "queue_position": 0,
  "status_url": "https://api.minicut.ai/v1/queue/happy-horse/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/status",
  "response_url": "https://api.minicut.ai/v1/queue/happy-horse/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd",
  "cancel_url": "https://api.minicut.ai/v1/queue/happy-horse/requests/0192f3a4-5b6c-7d8e-9f01-23456789abcd/cancel",
  "price": "1.100000",
  "currency": "USD"
}
```

Page: https://api.minicut.ai/models/happy-horse
API reference: https://api.minicut.ai/docs/api
