[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Wan 2.5 Text to Video](https://spiral.ai/integrations/claude-code/wan-2-5-text-to-video)

# How to Use Wan 2.5 Text to Video in Claude Code

Wan 2.5 Text to Video creates short scenes with generated sound from a written description. Unlike Wan 2.5 Image to Video, it needs no starting image, making it useful for testing settings, subjects, and visual concepts from scratch.

|  |  |
| --- | --- |
| Model | Wan 2.5 Text to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.195 per second. Billed on `duration`, default 5. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Wan 2.5 Text to Video in Claude Code

- Read the campaign brief in this project and use Wan 2.5 Text to Video to create a 10-second 720p mood study. Choose one setting and one visible action, with background music that matches the brief.
- Use Wan 2.5 Text to Video to test the short scene description in the project's creative brief at 5 seconds and 720p. Generate one result with prompt expansion enabled and one with it disabled, then save both for comparison.
- Use Wan 2.5 Text to Video to create a 5-second 1080p background video for the café site in this project. Show steam rising from a ceramic cup in a close-up with morning window light and a quiet spoon clink.
- Estimate, then generate a 5-second 9:16 clip with Wan 2.5 Text to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Wan 2.5 Text to Video for a smartwatch, slow orbit shot, studio lighting.

## How to set up Wan 2.5 Text to Video in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Wan 2.5 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/wan-25-preview/text-to-video",
    "input": {
      "prompt": "The white dragon warrior stands still, eyes full of determination and strength. The camera slowly moves closer or circles around the warrior, highlighting the…"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Wan 2.5 Text to Video on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Wan 2.5 Text to Video tools and prices

- [Wan 2.5 Text to Video](https://spiral.ai/tools/fal/fal-ai/wan-25-preview/text-to-video) (fal): `resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.195 per second. Billed on `duration`, default 5.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| audio_url |  | — | URL of the audio to use as the background music. Must be publicly accessible. Limit handling: If the audio duration exceeds the duration value (5 or 10 seconds), the audio is truncated to the first 5 or 10 seconds, and the rest is discarded. If the audio is shorter than the video, the remaining part of the video will be silent. For example, if the audio is 3 seconds long and the video duration is 5 seconds, the first 3 seconds of the output video will have sound, and the last 2 seconds will be silent. - Format: WAV, MP3. - Duration: 3 to 30 s. - File size: Up to 15 MB. |
| aspect_ratio | 16:9, 9:16, 1:1 | 16:9 | The aspect ratio of the generated video |
| resolution | 480p, 720p, 1080p | 1080p | Video resolution tier |
| duration | 5, 10 | 5 | Duration of the generated video in seconds. Choose between 5 or 10 seconds. |
| negative_prompt |  | — | Negative prompt to describe content to avoid. Max 500 characters. |
| enable_prompt_expansion |  | true | Whether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. |

## What can you do with Wan 2.5 Text to Video in Claude Code?

Create short video assets while working on a website, app presentation, or campaign in your project. A coding agent can turn the creative brief into Wan 2.5 scenes and organize the results for review.

### Product teaser concepts

Stage a brief product scene from a written concept or animate a product still. Try a slow camera move with a matching sound, such as coffee pouring beside a mug.

### Storyboard motion tests

Test a scene description or bring a storyboard panel into motion. Use a short clip to judge framing, movement, and atmosphere before developing the next scene.

### Sound and action studies

Explore a visible action with matching audio, such as footsteps in snow or rain hitting a window. Build the scene from text or start from an image that already contains the subject.

### Short social explainers

Show one action, such as a seedling bending toward sunlight or a kettle releasing steam. Start with a written scene or a prepared illustration and keep the explanation within one clip.

### Atmosphere shots

Create a brief café, woodland, or rainy street scene with matching ambient sound. Describe the setting from scratch or animate an existing view.

### Imagined scene exploration

Test settings that have no starting artwork, such as a greenhouse on the moon or a miniature city inside a clock. Compare how different descriptions change the scene.

### Campaign mood studies

Explore how lighting, camera position, movement, and music change a campaign's mood. Use written concepts or approved stills as the starting point for separate short clips.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Wan 2.5 Text to Video in other agents

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

## More Claude Code guides

- [Wan 2.5 Image to Video](https://spiral.ai/integrations/claude-code/wan-2-5-image-to-video)
- [Wan 2.6 Image to Video](https://spiral.ai/integrations/claude-code/wan-2-6-image-to-video)
- [Wan 2.2 S2V 14B](https://spiral.ai/integrations/claude-code/wan-2-2-s2v-14b)
- [Wan 2.6 Image to Video Flash](https://spiral.ai/integrations/claude-code/wan-2-6-image-to-video-flash)
- [Wan 2.2 FastWan 5B Text to Video](https://spiral.ai/integrations/claude-code/wan-2-2-fastwan-5b-text-to-video)
- [Wan 2.6 Reference to Video](https://spiral.ai/integrations/claude-code/wan-2-6-reference-to-video)

## Questions about Wan 2.5 Text to Video in Claude Code

**Can Claude Code use Wan 2.5 Text to Video?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Wan 2.5 Text to Video like any built-in tool.

**How much does Wan 2.5 Text to Video cost in Claude Code?**

`resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.195 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 Claude Code plan is separate.

**Do I need a fal account to use Wan 2.5 Text to Video in Claude Code?**

No. Spiral runs Wan 2.5 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 Wan 2.5 Text to Video in Claude Code?**

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

**Does Claude Code wait while Wan 2.5 Text to Video runs?**

Wan 2.5 Text to Video runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.

**What is Wan 2.5 useful for?**

Use Wan 2.5 for short product teasers, scene concepts, animated illustrations, and atmosphere shots where sound helps explain the action. Give each clip one clear purpose, such as showing steam rise or introducing a character.

**How long can a Wan 2.5 video be?**

Each generation lasts 5 or 10 seconds, with output up to 1080p. For a longer piece, plan several short clips and edit them together.

**Does Wan 2.5 generate sound?**

Yes. Wan 2.5 can generate vocals, music, and sound effects alongside the visuals, so describe what the viewer should hear as well as see.

**Which languages can I use for prompts?**

Wan 2.5 accepts Chinese and English prompts. Alibaba documents a limit of 1,500 characters, so put the essential subject, action, and sound instructions first.

**When does prompt expansion help?**

Prompt expansion can help when your description is short or underspecified. For a carefully written scene, try it both ways and compare whether the added details match your intent.

