# Happy Horse 1.1 Reference to Video

Turn images into video with Happy Horse 1.1 Reference to Video from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `alibaba/happy-horse/v1.1/reference-to-video`
- Page: https://spiral.ai/tools/fal/alibaba/happy-horse/v1.1/reference-to-video

## Pricing

`resolution`: 720p $0.182, 1080p (default) $0.234 per second. Billed on `duration`, default 5.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | Text prompt describing the desired video. Reference subjects from your images using ``character1``, ``character2``, ... up to ``character9`` (the order matches the order of ``image_urls``). Max 2500 characters. |
| `image_urls` (required) | URLs or files |  | — | Reference images for subject consistency (1-9 images). Formats: JPEG, JPG, PNG, WEBP. Shortest side must be at least 400 px (720P or higher recommended). Max 20 MB each. |
| `aspect_ratio` | one of | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5 | 16:9 | Aspect ratio of the generated video. |
| `resolution` | one of | 720p, 1080p | 1080p | Output video resolution tier. |
| `duration` | one of | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | 5 | Output video duration in seconds (3-15). |
| `seed` | number (whole) |  | — | Random seed for reproducibility (0-2147483647). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "alibaba/happy-horse/v1.1/reference-to-video",
    "input": {
      "prompt": "A dance battle between character1 and character2, cinematic lighting, smooth camera movement.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=alibaba%2Fhappy-horse%2Fv1.1%2Freference-to-video

## Common questions

### Happy Horse 1.1 Reference to Video

**How much does Happy Horse 1.1 Reference to Video cost?**

`resolution`: 720p $0.182, 1080p (default) $0.234 per second. Billed on `duration`, default 5. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Happy Horse 1.1 Reference to Video through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "alibaba/happy-horse/v1.1/reference-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Happy Horse 1.1 Reference to Video?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Happy Horse 1.1 Reference to Video?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

