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

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

Wan 3.0 Text to Video creates scenes from written descriptions, including stories with multiple shots and generated sound. Unlike Wan 3.0 Image to Video, it starts without a supplied opening image.

|  |  |
| --- | --- |
| Model | Wan 3.0 Text to Video |
| Available through | fal |
| Category | Video |
| Price | `resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.26 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 3.0 Text to Video in Claude Code

- Read the creative brief in this project and use Wan 3.0 Text to Video to make a 15-second concept at 720p. Write three consecutive five-second shots, each with one action, a camera direction, and ambient sound.
- Read the campaign brief and use Wan 3.0 Text to Video to create a ten-second 1080p rain-soaked street scene. Request one continuous tracking shot, footsteps and rain, no dialogue, and no visible lettering.
- Estimate, then generate a 5-second 9:16 clip with Wan 3.0 Text to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
- Make a 10-second product teaser with Wan 3.0 Text to Video for a smartwatch, slow orbit shot, studio lighting.
- Generate three 5-second b-roll clips of a busy coffee shop with Wan 3.0 Text to Video and list what each cost.

## How to set up Wan 3.0 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 3.0 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": "alibaba/wan-3.0/text-to-video",
    "input": {
      "prompt": "A red panda walking through a bamboo forest at sunrise"
    }
  }'
```

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

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

## Wan 3.0 Text to Video tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| resolution | 480p, 720p, 1080p | 1080p | Output video resolution tier. |
| aspect_ratio | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive | Output aspect ratio, or adaptive selection. |
| duration | 2 to 30 | 5 | Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media. |
| audio |  | true | Include generated audio. |
| enable_prompt_expansion |  | true | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| enable_thinking |  | false | Enable enhanced reasoning before generation. |

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

Turn project creative briefs and visual assets into short video concepts with Wan 3.0. A coding agent can prepare shot descriptions from project files and help review generated clips for text and audio problems.

### Product storyboards

Explore a short product story with an establishing shot, a detail shot, and a closing scene. Describe the concept in text, animate a product still, or use references to guide its appearance.

### Destination video concepts

Build a short destination sequence around a landscape, a street scene, or local food. Use a written scene description or supplied imagery, then specify the camera movement and ambient sound.

### Animated short scenes

Create a brief animated scene with a clear action and reaction. Start with a written character description, an illustrated opening frame, or character references.

### Atmospheric cutaways

Generate supporting footage such as rain on a window, steam above coffee, or wind moving through grass. Specify a simple action, a deliberate camera move, and the sounds the scene needs.

## Overview

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

## Wan 3.0 Text to Video in other agents

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

## More Claude Code guides

- [Wan 3.0 Reference to Video](https://spiral.ai/integrations/claude-code/wan-3-0-reference-to-video)
- [WaveSpeed Video Background Remover](https://spiral.ai/integrations/claude-code/wavespeed-video-background-remover)
- [Wan 3.0 Prime Text to Video](https://spiral.ai/integrations/claude-code/wan-3-0-prime-text-to-video)
- [WaveSpeed Video Watermark Remover](https://spiral.ai/integrations/claude-code/wavespeed-video-watermark-remover)
- [Wan 3.0 Prime Reference to Video](https://spiral.ai/integrations/claude-code/wan-3-0-prime-reference-to-video)
- [Exa cited web answer](https://spiral.ai/integrations/claude-code/exa-cited-web-answer)

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

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

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

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

`resolution`: 480p $0.065, 720p $0.13, 1080p (default) $0.26 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 3.0 Text to Video in Claude Code?**

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

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

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

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

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

Wan 3.0 can generate up to 30 seconds in one pass. When you supply a video reference, Alibaba documents a combined limit of 30 seconds for the input video and generated output.

**What resolution and frame rate does Wan 3.0 produce?**

Wan 3.0 supports 480p, 720p, and 1080p output. Alibaba documents an output frame rate of 30 fps.

**Can Wan 3.0 generate sound with the video?**

Yes. Wan 3.0 can generate dialogue, background music, and sound effects alongside the visuals.

**How should I write a Wan 3.0 prompt?**

Describe the subject, setting, action, camera movement, and sound. For several shots, give each shot a number and time range; for an uninterrupted take, explicitly request one continuous shot.

**What should I check before using a Wan 3.0 video?**

Check any visible text and listen closely to the audio. Alibaba identifies on-screen text accuracy and audio texture as areas that still need improvement.

