[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Happy Horse 1.1 Reference to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-reference-to-video)

# How to Use Happy Horse 1.1 Reference to Video in opencode

Build scenes around recognizable characters or products using up to nine reference images. Choose this version when subject consistency matters across new scenes.

|  |  |
| --- | --- |
| Model | Happy Horse 1.1 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 720p $0.182, 1080p (default) $0.234 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Happy Horse 1.1 Reference to Video in opencode

- Use Happy Horse 1.1 Reference to Video with the project's mascot reference as character1. Create a 5-second square 1080p scene of character1 waving beside a garden gate, camera locked, with soft outdoor ambience.
- Estimate, then generate a 5-second 9:16 clip with Happy Horse 1.1 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Happy Horse 1.1 Reference to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Happy Horse 1.1 Reference to Video and list what each cost.
- Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Happy Horse 1.1 Reference to Video.

## How to set up Happy Horse 1.1 Reference to Video in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Happy Horse 1.1 Reference to Video**: One request; the result comes back by polling or a webhook.

```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>"
      ]
    }
  }'
```

Then paste one of the prompts above: opencode finds Happy Horse 1.1 Reference to Video on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Happy Horse 1.1 Reference to Video tools and prices

- [Happy Horse 1.1 Reference to Video](https://spiral.ai/tools/fal/alibaba/happy-horse/v1.1/reference-to-video) (fal): `resolution`: 720p $0.182, 1080p (default) $0.234 per second. Billed on `duration`, default 5.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| aspect_ratio | 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 | 720p, 1080p | 1080p | Output video resolution tier. |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | 5 | Output video duration in seconds (3-15). |
| seed |  | — | Random seed for reproducibility (0-2147483647). |

## What can you do with Happy Horse 1.1 Reference to Video in opencode?

Create short video assets from the project's artwork and scene briefs. Use an opening still for an approved composition or references for subjects that recur in several scenes.

### Animate an approved visual

Turn a product still or character illustration into a short moving shot. Start with Image to Video and direct one action and one camera move.

### Carry a subject into new scenes

Use Reference to Video to build several short scenes around the same product or character. Keep the reference order consistent and name each subject explicitly.

### Draft a scene with sound

Use Text to Video to explore a scene before creating its source artwork. Describe the visible action and the sound, then review both together.

### Plan a short sequence

Draft an 8- to 15-second sequence as timecoded shots. Assign one action to each segment so the requested edit is clear.

### Test a talking portrait

Animate a portrait with one short spoken line. Review lip-sync before adding more dialogue or extending the scene.

### Compare scene directions

Generate short variations of the same scene while changing one camera or lighting cue. Keep the rest of the brief consistent.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Happy Horse 1.1 Reference to Video in other agents

- [Amp](https://spiral.ai/integrations/amp/happy-horse-1-1-reference-to-video)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/happy-horse-1-1-reference-to-video)
- [Claude](https://spiral.ai/integrations/claude-desktop/happy-horse-1-1-reference-to-video)
- [Claude Code](https://spiral.ai/integrations/claude-code/happy-horse-1-1-reference-to-video)
- [Cline](https://spiral.ai/integrations/cline/happy-horse-1-1-reference-to-video)
- [Codex](https://spiral.ai/integrations/codex/happy-horse-1-1-reference-to-video)
- [Cursor](https://spiral.ai/integrations/cursor/happy-horse-1-1-reference-to-video)
- [Devin](https://spiral.ai/integrations/devin/happy-horse-1-1-reference-to-video)
- [dots](https://spiral.ai/integrations/dots/happy-horse-1-1-reference-to-video)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/happy-horse-1-1-reference-to-video)
- [Gemini](https://spiral.ai/integrations/gemini/happy-horse-1-1-reference-to-video)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/happy-horse-1-1-reference-to-video)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/happy-horse-1-1-reference-to-video)
- [goose](https://spiral.ai/integrations/goose/happy-horse-1-1-reference-to-video)
- [Grok](https://spiral.ai/integrations/grok/happy-horse-1-1-reference-to-video)
- [Grok Build](https://spiral.ai/integrations/grok-build/happy-horse-1-1-reference-to-video)
- [Hermes](https://spiral.ai/integrations/hermes/happy-horse-1-1-reference-to-video)
- [Instinct](https://spiral.ai/integrations/instinct/happy-horse-1-1-reference-to-video)
- [Manus](https://spiral.ai/integrations/manus/happy-horse-1-1-reference-to-video)
- [Muse](https://spiral.ai/integrations/muse/happy-horse-1-1-reference-to-video)
- [Muse Code](https://spiral.ai/integrations/muse-code/happy-horse-1-1-reference-to-video)
- [n8n](https://spiral.ai/integrations/n8n/happy-horse-1-1-reference-to-video)
- [Notion](https://spiral.ai/integrations/notion/happy-horse-1-1-reference-to-video)
- [OpenClaw](https://spiral.ai/integrations/openclaw/happy-horse-1-1-reference-to-video)
- [Perplexity](https://spiral.ai/integrations/perplexity/happy-horse-1-1-reference-to-video)
- [Raycast](https://spiral.ai/integrations/raycast/happy-horse-1-1-reference-to-video)
- [VS Code](https://spiral.ai/integrations/vscode/happy-horse-1-1-reference-to-video)
- [Windsurf](https://spiral.ai/integrations/windsurf/happy-horse-1-1-reference-to-video)
- [Zapier](https://spiral.ai/integrations/zapier/happy-horse-1-1-reference-to-video)

## More opencode guides

- [Happy Horse 1.1 Image to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-image-to-video)
- [Happy Horse 1.1 Text to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-text-to-video)
- [Happy Horse 1.0 Text to Video](https://spiral.ai/integrations/opencode/happy-horse-1-0-text-to-video)
- [Happy Horse Video Edit](https://spiral.ai/integrations/opencode/happy-horse-video-edit)
- [Happy Horse 1.0 Reference to Video](https://spiral.ai/integrations/opencode/happy-horse-1-0-reference-to-video)
- [Hedra Character 3](https://spiral.ai/integrations/opencode/hedra-character-3)

## Questions about Happy Horse 1.1 Reference to Video in opencode

**Can opencode use Happy Horse 1.1 Reference to Video?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Happy Horse 1.1 Reference to Video like any built-in tool.

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

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

**Do I need a fal account to use Happy Horse 1.1 Reference to Video in opencode?**

No. Spiral runs Happy Horse 1.1 Reference to Video on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Happy Horse 1.1 Reference to Video in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while Happy Horse 1.1 Reference to Video runs?**

Happy Horse 1.1 Reference to Video runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.

**Which Happy Horse 1.1 version should I choose?**

Use Text to Video to explore a scene from written direction. Use Image to Video to animate a particular opening image, or Reference to Video when recognizable subjects need to carry into new scenes.

**Does Happy Horse 1.1 generate sound?**

Yes. It generates dialogue, ambient sound, and effects alongside the picture, with multilingual lip-sync for speech.

**How long and detailed can the output be?**

Clips run from 3 to 15 seconds and reach 1080p, with 24 fps MP4 output. Plan longer pieces as several clips.

**How do I keep a character recognizable?**

Use Reference to Video and identify subjects as character1, character2, and so on, matching the supplied image order. It supports up to nine reference images.

**How should I write a scene with several shots?**

Give each shot its own time range and action, such as 0-4 seconds for an establishing shot and 4-8 seconds for a close-up. Keep the full sequence within 15 seconds.

