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

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

Build a scene around recognizable subjects from one to nine reference images. Unlike Happy Horse 1.0 Image to Video, it uses those images to guide subject appearance rather than fix the opening frame.

|  |  |
| --- | --- |
| Model | Happy Horse 1.0 Reference to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 720p $0.182, 1080p (default) $0.364 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.0 Reference to Video in opencode

- Use Happy Horse 1.0 Reference to Video with the two character portraits in the game's assets, in their existing order. Generate eight seconds at 1080p: character1 waits beside a forest gate while character2 approaches, leaves moving in the breeze, soft footsteps.
- Estimate, then generate a 5-second 9:16 clip with Happy Horse 1.0 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.0 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.0 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.0 Reference to Video.

## How to set up Happy Horse 1.0 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.0 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/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.0 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.0 Reference to Video tools and prices

- [Happy Horse · Reference to Video](https://spiral.ai/tools/fal/alibaba/happy-horse/reference-to-video) (fal): `resolution`: 720p $0.182, 1080p (default) $0.364 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 | 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.0 Reference to Video in opencode?

Create short video assets for a website, game prototype, or product presentation. A coding agent can turn project briefs into scene descriptions and place selected clips in the project.

### Advertising concept tests

Try a five-second scene that communicates one advertising idea, such as a steaming cup beside a rainy window. Compare lighting and atmosphere before planning a longer production.

### Short fictional dialogue

Create a brief exchange between fictional characters with spoken lines and environmental sound. Keep the dialogue short enough to finish within the clip.

### Social media scenes

Make a compact visual joke, reaction, or atmospheric scene for a social post. Build each clip around one clear action.

### Product scene concepts

Explore how a product could appear in a short commercial scene with specific lighting, movement, and sound. Use the result to discuss the creative direction.

### Storyboard motion studies

Test the action and atmosphere of a short narrative beat before filming or animating it. Generate individual clips for a longer storyboard.

### Reference-based character scenes

Place recognizable subjects from supplied reference images into a newly described scene. Identify each subject by its numbered character label.

## Overview

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

## Happy Horse 1.0 Reference to Video in other agents

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

## More opencode guides

- [Happy Horse 1.0 Image to Video](https://spiral.ai/integrations/opencode/happy-horse-1-0-image-to-video)
- [Happy Horse 1.0 Text to Video](https://spiral.ai/integrations/opencode/happy-horse-1-0-text-to-video)
- [Hailuo T2V-01 Director](https://spiral.ai/integrations/opencode/hailuo-t2v-01-director)
- [Happy Horse 1.1 Image to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-image-to-video)
- [Hailuo S2V-01](https://spiral.ai/integrations/opencode/hailuo-s2v-01)
- [Happy Horse 1.1 Reference to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-reference-to-video)

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

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

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

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

`resolution`: 720p $0.182, 1080p (default) $0.364 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.0 Reference to Video in opencode?**

No. Spiral runs Happy Horse 1.0 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.0 Reference to Video in opencode?**

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

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

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

**What is Happy Horse 1.0 useful for?**

Short advertising concepts, social videos, product scenes, and fictional dialogue are practical starting points. It can combine moving images with dialogue and ambient sound in the same clip.

**How long can a Happy Horse 1.0 video be?**

Each clip lasts 3 to 15 seconds, with output at 720p or 1080p. Plan longer pieces as separate clips to assemble afterward.

**Does Happy Horse 1.0 generate sound?**

Yes. It generates synchronized audio, including dialogue, environmental sound, and sound effects. Describe the sounds you want alongside the visible action.

**Which languages support lip-sync?**

The documented languages are English, Mandarin, Cantonese, Japanese, Korean, German, and French. Specify the spoken language and write the intended dialogue in your scene description.

**What should I include in a prompt?**

Describe the subject, its action, the setting, lighting, and mood. Add a clear camera cue when it matters, such as a slow push-in, and describe any dialogue or environmental sound.

