MCP Server Guide

Use Seedream V4 Edit from Claude Code

Seedream V4 Edit is Bytedance's purpose-built image editing model. Pair it with a source image URL and a prompt describing the change. Excellent for compositional edits, style swaps, and detail revisions while preserving the original subject.

If you use Claude Code and you want Seedream V4 Edit 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
seedream-v4-edit
Provider
Bytedance via KIE.ai
Cost
7 cr per image, supports 4K
Outputs per call
1

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Seedream V4 Edit from the model-selection rubric in the tool description when your prompt matches its strengths (deterministic image editing).

Example interaction:

You
Generate editing photoreal images while preserving subjects

Claude Code calls aetherwave_edit_image with model: "seedream-v4-edit" 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
"Make the sky a dramatic sunset with golden hour lighting"
Example 2
"Add subtle film grain and a slight purple lens flare in the upper left"
Example 3
"Replace the background with a modern Scandinavian living room"

When to pick Seedream V4 Edit

Seedream V4 Edit shines for:

How it compares

vs grok-imagine-i2i at 10 cr / 1 image: Seedream V4 Edit returns 1 deterministic edit at 7 cr; Grok I2I returns 1 variation at 10 cr. Pick Seedream for predictable edits; Grok for variation.

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

Cost

Flat 7 credits per image, with optional 4K mode and multi-image batches. Image-to-image editing variant of Seedream V4.

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 Seedream V4 Edit available as part of the aetherwave_edit_image tool with 1 output(s) per call.

How do I use Seedream V4 Edit from Claude Code?

Just describe what you want. The agent picks Seedream V4 Edit when your prompt matches its strengths (deterministic image editing). You can also explicitly request it by passing model: "seedream-v4-edit" in the tool call.

What does Seedream V4 Edit cost per generation?

Flat 7 credits per image, with optional 4K mode and multi-image batches. Image-to-image editing variant of Seedream V4. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Seedream V4 Edit from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Seedream V4 Edit generation in under five minutes.

Get Your Free API Key