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

# How to Use Wan 2.7 Image to Image in Claude Code

Wan 2.7 Image to Image changes an existing picture with written instructions, from a new background to a pencil drawing. Unlike Wan 2.7 Text to Image, it starts with a reference image.

|  |  |
| --- | --- |
| Model | Wan 2.7 Image to Image |
| Available through | fal |
| Category | Image |
| Price | $0.039 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Wan 2.7 Image to Image in Claude Code

- Use Wan 2.7 Image to Image to revise the product photo in this project's assets: replace the background with a matte gray tabletop, preserve the object's shape and label, and return one 1024 × 1024 image.
- Use Wan 2.7 Image to Image to update the date on the event poster in this project's assets to October 12. Preserve the illustration and all other wording; return one 2048 × 2048 image.
- Remove the background from the photo I attach with Wan 2.7 Image to Image and give me a transparent PNG. Save the result in ./assets.
- Use Wan 2.7 Image to Image to clean up these product shots so they sit on pure white.
- Edit this image with Wan 2.7 Image to Image: keep the subject, swap the background for a sunlit studio.

## How to set up Wan 2.7 Image to Image 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.7 Image to Image**: 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/v2.7/edit",
    "input": {
      "prompt": "Turn image 1 into a watercolor painting.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

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

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

## Wan 2.7 Image to Image tools and prices

- [Wan 2.7 · Image to Image](https://spiral.ai/tools/fal/fal-ai/wan/v2.7/edit) (fal): $0.039 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | Content to avoid in the generated image. Max 500 characters. |
| image_size |  | square_hd | Output image size. Uses fal image size presets or explicit dimensions and is converted to DashScope size format. |
| num_images | 1 to 4 | 1 | Number of images to generate (1-4). |
| enable_prompt_expansion |  | true | Enable DashScope prompt expansion. Supported only for image edit mode. |
| seed |  | — | Random seed for reproducibility (0-2147483647). |
| output_format | jpeg, png, webp | jpeg | The format of the generated images. |

## What can you do with Wan 2.7 Image to Image in Claude Code?

Turn a project's visual requirements into images that fit its screens and content. Use Wan 2.7 Image for text-bearing graphics and detailed compositions, then inspect the results in the actual layout.

### Product background revisions

Revise a supplied product photo with a different setting, lighting treatment, or surrounding props while asking to preserve the product's appearance.

### Portrait style studies

Turn a supplied portrait into a pencil drawing or watercolor study, with explicit instructions about which facial features to preserve.

### Poster text revisions

Update a headline or date in a supplied graphic while asking to keep its layout, illustration, and remaining wording.

### Reference-based compositions

Combine elements from supplied images into a composition, identifying which image supplies each subject, background, or visual treatment.

## Overview

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

## Wan 2.7 Image to Image in other agents

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

## More Claude Code guides

- [Wan 2.6 Text to Image](https://spiral.ai/integrations/claude-code/wan-2-6-text-to-image)
- [Wan 2.7 Pro Edit](https://spiral.ai/integrations/claude-code/wan-2-7-pro-edit)
- [Wan 2.6 Image to Image](https://spiral.ai/integrations/claude-code/wan-2-6-image-to-image)
- [Wan 2.7 Pro Text to Image](https://spiral.ai/integrations/claude-code/wan-2-7-pro-text-to-image)
- [Wan 2.5 Text to Image](https://spiral.ai/integrations/claude-code/wan-2-5-text-to-image)
- [Wan 2.7 Text to Image](https://spiral.ai/integrations/claude-code/wan-2-7-text-to-image)

## Questions about Wan 2.7 Image to Image in Claude Code

**Can Claude Code use Wan 2.7 Image to Image?**

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

**How much does Wan 2.7 Image to Image cost in Claude Code?**

$0.039 per image. Billed on `num_images`, default 1. 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.7 Image to Image in Claude Code?**

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

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

**Does Claude Code wait while Wan 2.7 Image to Image runs?**

Wan 2.7 Image to Image runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

**What is Wan 2.7 Image useful for?**

Wan 2.7 Image is useful for posters, illustrated content, and visual work that combines readable text with a specified composition. Alibaba highlights text rendering, subject consistency, and complex instruction following.

**Can Wan 2.7 Image put text inside a picture?**

Yes. Text rendering is one of its documented strengths, making it useful for poster headlines, labels, and illustrated explainers. Give the exact wording and check the result before publishing.

**Does Wan 2.7 Image support multilingual text?**

Alibaba reports text rendering in 12 languages. For a localized graphic, supply the approved wording rather than asking the image model to translate it.

**How should I describe the picture I want?**

Specify the subject, setting, style, lighting, and composition. For example, describe a ceramic mug photographed from above on a wooden table in morning window light, rather than asking for a nice product picture.

**Can Wan 2.7 Image make a 2048 × 2048 image?**

Yes. A square image at 2048 × 2048 fits the documented 2K output limit shared across these models.

