How to Use Wan 2.5 Image to Image in Codex
Wan 2.5 Image to Image edits reference images with instructions while preserving the subject. Unlike Wan 2.5 Text to Image, it can combine elements from existing images for product scenes and visual revisions.
Prompts to try with Wan 2.5 Image to Image in Codex
Copy an example into Codex, or ask in your own words.
Use Wan 2.5 Image to Image to revise the product photo in public/assets: replace the background with a sunlit kitchen counter. Preserve the product's shape and color, request 1024 × 1024, and show the result beside the original.
Use Wan 2.5 Image to Image on our existing article illustration to change its treatment to watercolor. Keep the main subject and composition, request 1280 × 720, and add the result to a local preview.
Generate a product photo with Wan 2.5 Image to Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
Make four logo concepts for a coffee brand called "Northline" with Wan 2.5 Image to Image.
Create a 16:9 hero image of a quiet mountain cabin at dusk with Wan 2.5 Image to Image.
How to set up Wan 2.5 Image to Image in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Wan 2.5 Image to Image
One request; the result comes back by polling or a webhook.
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-image", "input": { "prompt": "Reimagine the scene under a raging thunderstorm at night: lightning forks across the sky, illuminating the samurai in stark flashes of white light.", "image_urls": [ "<image_urls>" ] } }'
Then paste one of the prompts above: Codex finds Wan 2.5 Image to Image on Spiral, shows the price and runs it.
Wan 2.5 Image to Image providers and prices
Spiral runs Wan 2.5 Image to Image through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Wan 2.5 Image to Image works from your prompt and image URLs. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Negative prompt | what to leave out, in words | Negative prompt to describe content to avoid. Max 500 characters. | |
| Number of images | 1 to 4 | 1 | Number of images to generate. Values from 1 to 4. |
| Seed | a whole number | Random seed for reproducibility. If None, a random seed is chosen. |
Every API field of Wan 2.5 · Image to Image is on its tool page: open its card above.
What can you do with Wan 2.5 Image to Image in Codex?
Turn project briefs into artwork you can inspect in the actual page layout with Wan 2.5. Let the coding agent prepare focused image instructions and place reviewed results beside the relevant content.
Product campaign concepts
Create a product scene from a written brief with Wan 2.5 Text to Image, or restage a supplied product photo with Wan 2.5 Image to Image. Specify the surface, lighting, and room for copy.
Article cover artwork
Illustrate an article's central idea from text or revise supplied artwork. Use a wide composition with a clear focal point and deliberate space for the title.
Social campaign artwork
Draft square campaign images from a brief or adapt an existing campaign image. Specify one message, a defined palette, and a simple composition for review.
Illustration style exploration
Explore watercolor, photographic, or painterly treatments of a scene. Start from a description with Wan 2.5 Text to Image or a supplied image with Wan 2.5 Image to Image.
Product photo background changes
Use Wan 2.5 Image to Image to place a supplied product in a different setting. State which product details should remain and describe the replacement background and lighting.
Reference image composites
Use Wan 2.5 Image to Image to combine an object from one supplied image with a scene from another. Identify each image's role and specify placement, scale, and lighting.
More on Wan 2.5 Image to Image and Codex
Overview
Wan 2.5 Image to Image in other agents
Questions about Wan 2.5 Image to Image in Codex
Can Codex use Wan 2.5 Image to Image?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Wan 2.5 Image to Image like any built-in tool.
How much does Wan 2.5 Image to Image cost in Codex?
$0.065 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 Codex plan is separate.
Do I need a fal account to use Wan 2.5 Image to Image in Codex?
No. Spiral runs Wan 2.5 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.5 Image to Image in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Wan 2.5 Image to Image runs?
Wan 2.5 Image to Image runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
How should I write a Wan 2.5 prompt?
Describe the subject, setting, visual style, camera angle, lighting, and composition. As a practical starting point, give each instruction a clear purpose, such as leaving empty space above the subject for a headline.
Can I prompt Wan 2.5 in English or Chinese?
Yes, Wan 2.5 accepts instructions in English and Chinese. Use concrete descriptions of what should appear in the image.
What image dimensions should I start with?
A practical starting point is 1024 × 1024 for square artwork or 1280 × 720 for a wide composition. Both sizes fit the documented limits for Wan 2.5 image generation and editing.
Can Wan 2.5 produce native 4K square images?
No. A 4096 × 4096 output exceeds the documented limits for Wan 2.5 image generation and editing; plan a separate enlargement step if you need that size.
Will using the same seed reproduce an image exactly?
A fixed seed helps compare results, but it does not guarantee an identical image. Save an approved output instead of relying on regenerating it later.
Start using Wan 2.5 Image to Image in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


