[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Happy Horse Video Edit](https://spiral.ai/integrations/opencode/happy-horse-video-edit)

# How to Use Happy Horse Video Edit in opencode

Use Happy Horse Video Edit to restyle footage or replace selected elements while retaining the original motion. It works on an existing clip and returns up to 15 seconds, making it useful for outfit changes, product swaps, and alternate visual treatments.

|  |  |
| --- | --- |
| Model | Happy Horse Video Edit |
| Available through | fal |
| Category | Video |
| Price | Up to $43.68 per run at the default inputs for 60 seconds of input. `resolution`: 720p $21.84, 1080p (default) $43.68. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Happy Horse Video Edit in opencode

- Use Happy Horse Video Edit on assets/video/product-demo.mp4. Take a 10-second excerpt, replace the bottle with the product shown in assets/images/new-bottle.png, and request that the hand and camera movements stay consistent. Save a 1080p comparison copy.
- Use Happy Horse Video Edit on assets/video/presenter.mp4. Prepare an 8-second excerpt and replace the background with the setting in assets/images/studio.jpg. Ask to retain the presenter's appearance and movement, then save the result at 1080p.
- Use Happy Horse Video Edit to make a 720p style test from a 6-second excerpt of assets/video/walkthrough.mp4. Apply the watercolor treatment shown in assets/images/style-reference.png while retaining the shot's original motion.
- Use Happy Horse Video Edit on a 12-second excerpt of assets/video/fashion.mp4. Replace the model's jacket with the jacket in assets/images/jacket.jpg. Request that the pose, face, and walking motion stay consistent, and save at 1080p.
- Use Happy Horse Video Edit to create two separate color treatments of the same 8-second excerpt from assets/video/hero.mp4: warm muted colors and neutral monochrome. Save both at 720p with descriptive filenames.

## How to set up Happy Horse Video Edit 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 Video Edit**: 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/video-edit",
    "input": {
      "video_url": "https://storage.googleapis.com/falserverless/example_inputs/editto/example_in.mp4",
      "prompt": "Recolor the sky to a deep purple sunset."
    }
  }'
```

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

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

## Happy Horse Video Edit tools and prices

- [Happy Horse Video Edit · Edit Video](https://spiral.ai/tools/fal/alibaba/happy-horse/video-edit) (fal): Up to $43.68 per run at the default inputs for 60 seconds of input. `resolution`: 720p $21.84, 1080p (default) $43.68.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| reference_image_urls |  | — | Optional reference images used to guide the edit (up to 5). Formats: JPEG, JPG, PNG, WEBP. Dimensions must be at least 300px. Aspect ratio between 1:2.5 and 2.5:1. Max 10 MB each. |
| resolution | 720p, 1080p | 1080p | Output video resolution tier. |
| audio_setting | auto, origin | auto | Audio handling. 'auto': model decides whether to regenerate audio. 'origin': preserve the original audio from the input video. |
| seed |  | — | Random seed for reproducibility (0-2147483647). |

## What can you do with Happy Horse Video Edit in opencode?

Turn project footage into alternate product shots, wardrobe previews, or visual style tests. A coding agent can locate the source assets, prepare a short clip, and save edited results beside the originals for comparison.

### Product swap previews

Use Happy Horse Video Edit to replace a product in an existing demonstration clip. Supply a product reference image and request that the hand movement and camera motion stay consistent.

### Wardrobe previews

Try a different jacket or sweater on a person in a short clip. Give Happy Horse Video Edit a clothing reference and identify exactly which garment to replace.

### Alternate backgrounds

Ask Happy Horse Video Edit to replace the setting behind a presenter while retaining the presenter's movement. Use a location reference image to describe the intended setting.

### Visual style tests

Apply an illustrated or painted treatment to existing footage with Happy Horse Video Edit. Compare treatments on the same short shot before choosing an art direction.

### Color treatment comparisons

Use Happy Horse Video Edit to explore warm, muted, or monochrome treatments for a campaign shot. Describe the treatment across the entire clip.

### Prop replacement

Replace a distracting tabletop object or change a scene prop with Happy Horse Video Edit. Identify the object's position and describe what should occupy that space.

## Overview

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

## Happy Horse Video Edit in other agents

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

## More opencode guides

- [Happy Horse 1.1 Text to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-text-to-video)
- [Hedra Character 3](https://spiral.ai/integrations/opencode/hedra-character-3)
- [Happy Horse 1.1 Reference to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-reference-to-video)
- [HeyGen Avatar III Digital Twin](https://spiral.ai/integrations/opencode/heygen-avatar-iii-digital-twin)
- [Happy Horse 1.1 Image to Video](https://spiral.ai/integrations/opencode/happy-horse-1-1-image-to-video)
- [HeyGen Avatar IV](https://spiral.ai/integrations/opencode/heygen-avatar-iv)

## Questions about Happy Horse Video Edit in opencode

**Can opencode use Happy Horse Video Edit?**

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

**How much does Happy Horse Video Edit cost in opencode?**

Up to $43.68 per run at the default inputs for 60 seconds of input. `resolution`: 720p $21.84, 1080p (default) $43.68. 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 Video Edit in opencode?**

No. Spiral runs Happy Horse Video Edit 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 Video Edit in opencode?**

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

**Does opencode wait while Happy Horse Video Edit runs?**

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

**What is Happy Horse Video Edit good for?**

It is useful when the motion in an existing shot already works and you want different visuals. You can request a whole-scene style change or target an element such as clothing, a prop, or the background.

**Can Happy Horse Video Edit edit a full minute of footage?**

Each output is capped at 15 seconds. A longer input contributes only its first 15 seconds, so split longer footage into separate shots before editing.

**What video format and frame rate does Happy Horse Video Edit produce?**

Alibaba lists MP4 output at 24 frames per second, with 720p and 1080p resolution tiers. Output clips run from 3 to 15 seconds.

**How should I describe an edit?**

For a targeted change, name the object and where it appears, then describe its replacement. For a whole-scene change, describe the intended visual treatment across the clip.

**Do Happy Horse Video Edit instructions have to be in English?**

No. Alibaba documents support for instructions in any language; that statement concerns edit prompts rather than a guarantee about translated dialogue.

