MCP Server Guide

Use GPT Image 2 from Claude Code

GPT Image 2 is OpenAI's flagship general-purpose image model and AetherWave's recommended default when a user wants one strong result instead of variations. Top-tier quality across photoreal, illustration, typography, and composition. The front-runner for serious creative output.

If you use Claude Code and you want GPT Image 2 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
gpt-image-2-t2i
Provider
OpenAI via KIE.ai
Cost
9 cr per image at 1K, higher at 2K
Outputs per call
1

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick GPT Image 2 from the model-selection rubric in the tool description when your prompt matches its strengths (premium single-output image generation).

Example interaction:

You
Generate photoreal product photography and lifestyle shots

Claude Code calls aetherwave_generate_image with model: "gpt-image-2-t2i" 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 close-up of a vintage Roland synthesizer with glowing dials at dusk, soft purple bokeh, photorealistic"
Example 2
"Editorial portrait of a musician in a rain-soaked alley, neon signs reflecting off wet pavement, 35mm film grain"
Example 3
"Brand hero shot, moody synthwave workspace with neon accents, 16:9, magazine-quality"

When to pick GPT Image 2

GPT Image 2 shines for:

How it compares

vs grok-imagine-t2i at 6 cr / 2 images: GPT Image 2 returns 1 strong image at 9 cr; Grok returns 2 at about 3 cr/image but quality varies. Pick GPT Image 2 when you want one shot; Grok when you want cheap variations.

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

Cost

Fixed 9 credits per output at 1K resolution. Single deterministic image, no tiered quality knob. The model self-selects rendering depth from the prompt complexity.

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 GPT Image 2 available as part of the aetherwave_generate_image tool with 1 output(s) per call.

How do I use GPT Image 2 from Claude Code?

Just describe what you want. The agent picks GPT Image 2 when your prompt matches its strengths (premium single-output image generation). You can also explicitly request it by passing model: "gpt-image-2-t2i" in the tool call.

What does GPT Image 2 cost per generation?

Fixed 9 credits per output at 1K resolution. Single deterministic image, no tiered quality knob. The model self-selects rendering depth from the prompt complexity. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try GPT Image 2 from Claude Code

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

Get Your Free API Key