[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [PixVerse VibeMV](https://spiral.ai/integrations/codex/pixverse-vibemv)

# How to Use PixVerse VibeMV in Codex

PixVerse VibeMV turns an existing song into a music video that follows the audio's length, from 10 seconds to 6 minutes. Use a character photo to guide the performer and a style reference to shape the look.

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

## Prompts to try with PixVerse VibeMV in Codex

- Use PixVerse VibeMV to turn assets/audio/chorus.wav into a 30-second vertical release teaser. Trim the audio first if needed, choose Cinematic with Pop, and render at 1080p.
- Use PixVerse VibeMV with assets/audio/theme.wav and assets/characters/singer.png to make a landscape music video at 1080p. Check that the track is between 10 seconds and 6 minutes, and enable lip sync only if it contains vocals.
- Use PixVerse VibeMV to compare Lo-fi and Claymation treatments of the same 20-second excerpt from assets/audio/demo.wav. Render both at 720p and save them for review.
- Use PixVerse VibeMV to visualize 45 seconds of assets/audio/game-score.wav in Retro Game style at 1080p, landscape. Keep lip sync off because the score is instrumental.
- Use PixVerse VibeMV with the project's artist portrait, style reference, and a 30-second vocal excerpt. Choose Custom style, render square at 1080p, and check whether the supplied lyrics appear before preparing the final captioned edit.

## How to set up PixVerse VibeMV in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 VibeMV**: 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": "pixverse/music-video/vibemv",
    "input": {
      "audio_url": "https://storage.googleapis.com/falserverless/model_tests/diffrythm/rock_en.wav"
    }
  }'
```

Then paste one of the prompts above: Codex finds PixVerse VibeMV on Spiral, shows the price and runs it.

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

## PixVerse VibeMV tools and prices

- [PixVerse VibeMV](https://spiral.ai/tools/fal/pixverse/music-video/vibemv) (fal): `resolution`: 720p (default) $0.078, 1080p $0.117 per second.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_url |  | — | Optional character reference image URL. |
| style_image_url |  | — | Optional style reference image URL. Only used with the Custom style. |
| music_style | Pop, Rock, Hip Hop, R&B, Jazz, Reggae, Country, Folk, Electronic, Classical, Soul, Funk, Metal, Ambient, Others | — | Optional musical genre used to guide the visuals. |
| style | Custom, Cinematic, Lo-fi, Dreamscape, Woolen Felt, Candy, Golden Age, Voxel, Retro Game, Claymation, Woodland Tale, Impressionism, Decadence, Futuristic, Chromatic Clash, Holiday | Cinematic | Visual style for the music video. |
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 | Aspect ratio of the generated video. |
| resolution | 720p, 1080p | 720p | Resolution of the generated video. |

## What can you do with PixVerse VibeMV in Codex?

Create music video assets from the project's songs and character artwork. An agent can prepare short audio excerpts, generate visual treatments, and place the results in the project for review.

### Full-song release video

Turn a finished song of up to 6 minutes into a music video, using the artist's photo to guide the on-screen performer.

### Chorus teaser

Start with a 30-second chorus excerpt and create a vertical video for a single-release announcement.

### Virtual musician performance

Pair a fictional performer's portrait with a song and a custom style reference to establish a visual identity.

### Instrumental soundtrack visuals

Create a video around a game score or electronic instrumental, keeping lip sync disabled.

### Music video concept pitch

Generate short treatments of the same audio excerpt with different visual styles for a director or artist to review.

### Brand jingle draft

Build a visual draft around a 15- to 30-second jingle, then edit the result for branding and delivery.

### Artist portrait performance

Use a clear artist portrait and a vocal excerpt to draft a singing performance with lip sync enabled.

### Release campaign cuts

Create landscape, vertical, and square treatments of a song excerpt for review before assembling the release campaign.

## Overview

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

## PixVerse VibeMV in other agents

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

## More Codex guides

- [PixVerse V6 Transition](https://spiral.ai/integrations/codex/pixverse-v6-transition)
- [Pixelcut Looping Video](https://spiral.ai/integrations/codex/pixelcut-looping-video)
- [PixVerse V6 Text to Video](https://spiral.ai/integrations/codex/pixverse-v6-text-to-video)
- [RIFE](https://spiral.ai/integrations/codex/rife)
- [PixVerse V6 Image to Video](https://spiral.ai/integrations/codex/pixverse-v6-image-to-video)
- [Seedance 1.0 Pro Fast Image to Video](https://spiral.ai/integrations/codex/seedance-1-0-pro-fast-image-to-video)

## Questions about PixVerse VibeMV in Codex

**Can Codex use PixVerse VibeMV?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run PixVerse VibeMV like any built-in tool.

**How much does PixVerse VibeMV cost in Codex?**

Up to $4.68 per run at the default inputs for 60 seconds of input. `resolution`: 720p (default) $4.68, 1080p $7.02. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need a fal account to use PixVerse VibeMV in Codex?**

No. Spiral runs PixVerse VibeMV 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 VibeMV in Codex?**

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

**Does Codex wait while PixVerse VibeMV runs?**

PixVerse VibeMV runs in the background. Codex starts the run, checks on it and gives you the video when it's ready.

**Can I direct PixVerse VibeMV with a scene-by-scene text prompt?**

VibeMV builds around the supplied audio rather than a freeform text prompt. Give your agent the song and a clear visual direction, then use the style and reference images to guide generation.

**How long can a PixVerse VibeMV video be?**

Supply audio between 10 seconds and 6 minutes. The video follows that audio's length, so trim the song first when you want a short teaser.

**Does PixVerse VibeMV generate 4K video?**

The documented output resolutions are 720p and 1080p. Plan your delivery around those sizes.

**How do I make the performer resemble a particular character?**

Supply a clear front-facing photo of that character. The reference helps guide the performer's identity throughout the video.

**Can I rely on PixVerse VibeMV for finished lyric subtitles?**

Check a sample before planning a lyric video. Although captions are documented, Scenario reports that supplied lyrics did not appear in its tests; add captions separately if they are missing.

