MCP Server Guide

Use Wan 2.7 Image from Claude Code

Wan 2.7 Image is Alibaba's flagship image model with native 4K support, thinking mode for complex compositions, and up to 10 reference images for multi-reference generation. Distinctive for handling extreme aspect ratios (8:1, 1:8) for ultra-wide and ultra-tall banners.

If you use Claude Code and you want Wan 2.7 Image available as a native tool that the agent can call directly, the AetherWave MCP server wires it up in one command. No SDK to learn, no separate API key per provider, no polling loop to write.

Install in 30 seconds

Run this from your terminal:

claude mcp add aetherwave \
-e AETHERWAVE_API_KEY=aw_live_your_key_here \
-- npx -y @aetherwave-studio/mcp

Get your API key at your Profile page under the Developer tab. New accounts start with free credits to try it without spending anything.

Quick facts

Model ID
wan-2-7-image
Provider
Alibaba via KIE.ai
Cost
7 cr per image, multi-output up to 4
Outputs per call
4

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Wan 2.7 Image from the model-selection rubric in the tool description when your prompt matches its strengths (4K multi-aspect multi-reference generation).

Example interaction:

You
Generate 4k production work at competitive pricing

Claude Code calls aetherwave_generate_image with model: "wan-2-7-image" and returns the finished asset URL. The result auto-saves to your AetherWave gallery (Cloudflare R2 hosted, no URL expiration).

Sample prompts that work well

Example 1
"Cinematic wide shot of Shanghai skyline at sunset, 21:9, photoreal"
Example 2
"Vertical mobile banner of a waterfall, 1:8 aspect ratio, ultra-tall"
Example 3
"Multi-character composition with 6 distinct figures, anime style, 16:9"

When to pick Wan 2.7 Image

Wan 2.7 Image shines for:

How it compares

vs seedream-v4 at 7 cr: Both are 7 cr with 4K support. Wan 2.7 returns 4 images per call (vs Seedream's 1 with multi mode), supports more extreme aspects, and has thinking mode. Pick Wan 2.7 for variation; Seedream for deterministic single output.

Run aetherwave_list_image_models from Claude Code to see the full live catalog with pricing.

Cost

Flat 7 credits per call, returns up to 4 images per generation via maxImages. Supports resolutions up to 4K, thinking mode, and sequential mode.

Credits come from your AetherWave account. Plans:

Frequently Asked Questions

How do I install AetherWave MCP in Claude Code?

One command (shown above). Then restart Claude Code. The agent will have Wan 2.7 Image available as part of the aetherwave_generate_image tool with 4 output(s) per call.

How do I use Wan 2.7 Image from Claude Code?

Just describe what you want. The agent picks Wan 2.7 Image when your prompt matches its strengths (4K multi-aspect multi-reference generation). You can also explicitly request it by passing model: "wan-2-7-image" in the tool call.

What does Wan 2.7 Image cost per generation?

Flat 7 credits per call, returns up to 4 images per generation via maxImages. Supports resolutions up to 4K, thinking mode, and sequential mode. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Wan 2.7 Image from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Wan 2.7 Image generation in under five minutes.

Get Your Free API Key