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

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

Wan 2.5 Image to Video animates a starting image with motion and generated sound. Unlike Wan 2.5 Text to Video, the image establishes the subject, scene, and style, so your prompt can focus on movement.

|  |  |
| --- | --- |
| Model | Wan 2.5 Image 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 Image to Video in Claude Code

- Use Wan 2.5 Image to Video with the product still in this project's assets to create a 5-second 1080p teaser. Request a slow push toward the product, soft window light, and quiet room ambience.
- Use Wan 2.5 Image to Video to animate the opening storyboard panel in this project for 5 seconds at 720p. Focus the prompt on the main subject's movement and a fixed camera, with matching ambient sound.
- Animate the image I attach with Wan 2.5 Image to Video: slow push-in, leaves moving in the wind. Save the result in ./assets.
- Turn this product photo into a 5-second rotating shot with Wan 2.5 Image to Video.
- Bring this portrait to life with Wan 2.5 Image to Video: a subtle smile and a blink.

## How to set up Wan 2.5 Image 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 Image 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/image-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…",
      "image_url": "https://storage.googleapis.com/falserverless/model_tests/wan/dragon-warrior.jpg"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Wan 2.5 Image 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 Image to Video tools and prices

- [Wan 2.5 Image to Video](https://spiral.ai/tools/fal/fal-ai/wan-25-preview/image-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. |
| resolution | 480p, 720p, 1080p | 1080p | Video resolution. Valid values: 480p, 720p, 1080p |
| 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. |
| seed |  | — | Random seed for reproducibility. If None, a random seed is chosen. |

## What can you do with Wan 2.5 Image 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.

### Illustration animation

Animate an existing drawing with a small gesture, moving fabric, or drifting clouds. Let the image establish the appearance and use the prompt to direct motion.

### 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 Image to Video in other agents

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

## More Claude Code guides

- [Wan 2.2 S2V 14B](https://spiral.ai/integrations/claude-code/wan-2-2-s2v-14b)
- [Wan 2.5 Text to Video](https://spiral.ai/integrations/claude-code/wan-2-5-text-to-video)
- [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 Image to Video](https://spiral.ai/integrations/claude-code/wan-2-6-image-to-video)
- [Wan 2.2 Animate Replace](https://spiral.ai/integrations/claude-code/wan-2-2-animate-replace)
- [Wan 2.6 Image to Video Flash](https://spiral.ai/integrations/claude-code/wan-2-6-image-to-video-flash)

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

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

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

**How much does Wan 2.5 Image 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 Image to Video in Claude Code?**

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

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

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

Wan 2.5 Image 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.

