[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Ovi Text to Video](https://spiral.ai/integrations/opencode/ovi-text-to-video)

# How to Use Ovi Text to Video in opencode

Ovi Text to Video turns a written scene into a short clip with generated speech, sound effects, and music. Unlike Ovi Image to Video, it creates the starting scene from text alone.

|  |  |
| --- | --- |
| Model | Ovi Text to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 512x960 $0.26, 512x992 $0.26, 720x720 $0.26, 960x512 $0.26, 992x512 (default) $0.26, 1120x448 $0.26, 448x1120 $0.26 per video. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Ovi Text to Video in opencode

- Use Ovi Text to Video to create a five-second preview of the first greeting in our game's dialogue script. Describe the character and setting from the project notes, choose one short line, wrap it in <S> and <E>, and add quiet room ambience inside <AUDCAP> and <ENDAUDCAP>.
- Use Ovi Text to Video to preview a five-second exchange for our tavern scene. The traveler says <S>Any rooms?<E> and the innkeeper replies <S>Just one.<E>. Hold a medium shot and add <AUDCAP>Two distinct voices, faint fireplace crackle.<ENDAUDCAP>.
- Use Ovi Text to Video to create a five-second atmosphere study for the harbor level described in our design document. Show waves tapping a wooden pier in one steady shot. Include <AUDCAP>Water lapping against wood, distant gull calls.<ENDAUDCAP>.
- Estimate, then generate a 5-second 9:16 clip with Ovi Text to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Ovi Text to Video for a smartwatch, slow orbit shot, studio lighting.

## How to set up Ovi Text 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 Ovi Text 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": "fal-ai/ovi",
    "input": {
      "prompt": "A close-up of someone'\''s face as they pet a cat, their hands stroking the soft fur in the foreground. Their affectionate expression shows as the cat purrs…"
    }
  }'
```

Then paste one of the prompts above: opencode finds Ovi Text to Video on Spiral, shows the price and runs it.

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

## Ovi Text to Video tools and prices

- [Ovi · Text to Video](https://spiral.ai/tools/fal/fal-ai/ovi) (fal): `resolution`: 512x960 $0.26, 512x992 $0.26, 720x720 $0.26, 960x512 $0.26, 992x512 (default) $0.26, 1120x448 $0.26, 448x1120 $0.26 per video.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  | jitter, bad hands, blur, distortion | Negative prompt for video generation. |
| num_inference_steps | 1 to 50 | 30 | The number of inference steps. |
| audio_negative_prompt |  | robotic, muffled, echo, distorted | Negative prompt for audio generation. |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |
| resolution | 512x992, 992x512, 960x512, 512x960, 720x720, 448x1120, 1120x448 | 992x512 | Resolution of the generated video in W:H format. One of (512x992, 992x512, 960x512, 512x960, 720x720, or 448x1120). |

## What can you do with Ovi Text to Video in opencode?

Create short scenes with generated dialogue and sound for game prototypes, character previews, or project presentations. Use project scripts and artwork to prepare focused Ovi scenes for review.

### Character introductions

Create a five-second introduction with one short spoken line and a small gesture. Start with a written character description or an existing portrait.

### Dialogue rehearsals

Try a brief question and reply before committing to a script. Keep both speakers visible and give each a clearly assigned line.

### Product scene concepts

Preview a short product scene with an action and its sound, such as opening a jar or setting down a ceramic cup. Use a written scene or a product image as the starting point.

### Game dialogue previews

Test how a short character line works alongside an expression, gesture, and background sound. Use the result to review a scene before producing final game assets.

### Atmosphere studies

Explore a rainy street, seaside lookout, or quiet workshop with matching ambient sound. Keep the scene to one shot and compare different sound descriptions.

### Short teaching scenes

Illustrate one simple action with a brief spoken cue, such as a barista saying to pour slowly while moving a kettle. Review the generated action before using it in instruction.

## Overview

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

## Ovi Text to Video in other agents

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

## More opencode guides

- [Ovi Image to Video](https://spiral.ai/integrations/opencode/ovi-image-to-video)
- [PixVerse C1 Image to Video](https://spiral.ai/integrations/opencode/pixverse-c1-image-to-video)
- [OmniHuman 2.0](https://spiral.ai/integrations/opencode/omnihuman-2-0)
- [PixVerse C1 Reference to Video](https://spiral.ai/integrations/opencode/pixverse-c1-reference-to-video)
- [OmniHuman 1.5](https://spiral.ai/integrations/opencode/omnihuman-1-5)
- [PixVerse C1 Text to Video](https://spiral.ai/integrations/opencode/pixverse-c1-text-to-video)

## Questions about Ovi Text to Video in opencode

**Can opencode use Ovi Text to Video?**

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

**How much does Ovi Text to Video cost in opencode?**

`resolution`: 512x960 $0.26, 512x992 $0.26, 720x720 $0.26, 960x512 $0.26, 992x512 (default) $0.26, 1120x448 $0.26, 448x1120 $0.26 per video. 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 Ovi Text to Video in opencode?**

No. Spiral runs Ovi Text 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 Ovi Text to Video in opencode?**

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

**Does opencode wait while Ovi Text to Video runs?**

Ovi Text to Video runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.

**Does Ovi generate sound as well as video?**

Yes. Ovi generates picture and sound together, including speech, environmental effects, and background music.

**How long are Ovi clips?**

Plan scenes for the original Ovi's five-second format at 24 fps. The maker also documents later ten-second checkpoints, so keep scripts for the listed Ovi models short.

**How do I tell Ovi what a character should say?**

Put the spoken words between <S> and <E>, such as <S>The door is open.<E>. Describe the character's action and expression around that line.

**Can Ovi make a conversation between two people?**

Yes. Ovi supports multiple speakers and conversational turns. For a five-second scene, try one brief exchange and identify who says each line.

**How should I describe background sounds?**

For the original Ovi, put ambience, effects, or music between <AUDCAP> and <ENDAUDCAP>. Use concrete sounds such as a cup touching a saucer or rain tapping a window.

