[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [PixVerse V4 Text to Video](https://spiral.ai/integrations/opencode/pixverse-v4-text-to-video)

# How to Use PixVerse V4 Text to Video in opencode

PixVerse V4 Text to Video creates short scenes from a written description without a starting image. Unlike PixVerse V4 Text to Video Fast, it supports 1080p output and eight-second clips at lower resolutions.

|  |  |
| --- | --- |
| Model | PixVerse V4 Text to Video |
| Available through | fal |
| Category | Video |
| Price | $0.26 per run at the default inputs. `resolution`: 360p $0.195, 540p $0.195, 720p (default) $0.26, 1080p $0.52. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with PixVerse V4 Text to Video in opencode

- Read the project's brand brief and use PixVerse V4 Text to Video to create a five-second, 1080p landscape shot: a paper boat drifts across a shallow puddle in soft morning light. Keep the camera still and save the result for review.
- Read the project's campaign notes and use PixVerse V4 Text to Video to make an eight-second, 720p landscape shot of mist drifting between pine trees at dawn. Save the exact prompt and seed beside the output.
- Estimate, then generate a 5-second 9:16 clip with PixVerse V4 Text to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with PixVerse V4 Text to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with PixVerse V4 Text to Video and list what each cost.

## How to set up PixVerse V4 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 PixVerse V4 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/pixverse/v4/text-to-video",
    "input": {
      "prompt": "Epic low-cut camera capture of a girl clad in ultraviolet threads, Peter Max art style depiction, luminous diamond skin glistening under a vast moon'\''s radiance,…"
    }
  }'
```

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

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

## PixVerse V4 Text to Video tools and prices

- [PixVerse V4 · Text to Video](https://spiral.ai/tools/fal/fal-ai/pixverse/v4/text-to-video) (fal): $0.26 per run at the default inputs. `resolution`: 360p $0.195, 540p $0.195, 720p (default) $0.26, 1080p $0.52.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 | 16:9 | The aspect ratio of the generated video |
| resolution | 360p, 540p, 720p, 1080p | 720p | The resolution of the generated video |
| duration | 5, 8 | 5 | The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds |
| negative_prompt |  |  | Negative prompt to be used for the generation. Limited to 2048 UTF-8 encoded bytes. Because the limit counts bytes rather than characters, emoji and non-Latin or accented characters (which use multiple bytes each) can push a visually short prompt over the cap. |
| style | anime, 3d_animation, clay, comic, cyberpunk | — | The style of the generated video |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same video every time. |

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

Create short visual assets for a project from its creative brief. Have the coding agent turn project notes into focused shots and prepare the results for review alongside the interface.

### Short ad concepts

Test one advertising idea per shot, such as steam rising from a coffee cup. Describe the scene from scratch or animate an approved still.

### Storyboard motion tests

Explore how a character enters a scene or turns toward the camera. Start with a written shot description or an existing storyboard panel.

### Atmospheric cutaways

Create a brief shot of rain, drifting mist, or leaves moving in window light. Build the setting from text or introduce motion into a landscape still.

### Stylized character beats

Try a clay character waving or an anime character looking up. Describe a new character or begin with an illustration, keeping the action brief.

### Scenes without reference art

Explore a setting before commissioning artwork: a paper boat crossing a puddle or a greenhouse at dawn. Write the subject, action, and environment directly.

### Social video framing studies

Generate portrait and landscape interpretations of a written scene. Compare how subject placement works in each composition before choosing a direction.

## Overview

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

## PixVerse V4 Text to Video in other agents

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

## More opencode guides

- [PixVerse V4 Image to Video Fast](https://spiral.ai/integrations/opencode/pixverse-v4-image-to-video-fast)
- [PixVerse V4 Text to Video Fast](https://spiral.ai/integrations/opencode/pixverse-v4-text-to-video-fast)
- [PixVerse V4 Image to Video](https://spiral.ai/integrations/opencode/pixverse-v4-image-to-video)
- [PixVerse V4.5 Image to Video](https://spiral.ai/integrations/opencode/pixverse-v4-5-image-to-video)
- [PixVerse V3.5 Text to Video Fast](https://spiral.ai/integrations/opencode/pixverse-v3-5-text-to-video-fast)
- [PixVerse V4.5 Image to Video Fast](https://spiral.ai/integrations/opencode/pixverse-v4-5-image-to-video-fast)

## Questions about PixVerse V4 Text to Video in opencode

**Can opencode use PixVerse V4 Text to Video?**

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

**How much does PixVerse V4 Text to Video cost in opencode?**

$0.26 per run at the default inputs. `resolution`: 360p $0.195, 540p $0.195, 720p (default) $0.26, 1080p $0.52. 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 PixVerse V4 Text to Video in opencode?**

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

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

**Does opencode wait while PixVerse V4 Text to Video runs?**

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

**What is PixVerse V4 useful for?**

Use it for short visual shots: ad concepts, storyboard tests, atmospheric cutaways, and animated character beats. Plan a single visible action for each shot.

**How should I write a PixVerse V4 prompt?**

Start with the subject, what it does, and where it is. Add concrete lighting and framing details, then remove repeated description.

**Can PixVerse V4 create a complete long scene in one generation?**

Treat it as a tool for short shots. For a longer story, plan separate clips and edit them together instead of packing the entire sequence into one prompt.

**How can I compare changes to a prompt?**

Keep the seed and output settings fixed, then change one instruction at a time. Save the exact prompt and model name with each result so you can revisit a useful baseline.

**Can PixVerse V4 make stylized animation?**

Yes, it supports treatments such as anime and clay. Use the selected treatment for appearance, and spend the prompt on what the subject does and how the shot is framed.

