Skip to main content

Use GPT Image 2 in Claude Code with MCP or a Skill

GPT Image 2 for Claude is an external image workflow: Claude plans the request, while GPT Image 2 renders the pixels through Claude Imagine. Connect the remote MCP server with OAuth, install the Claude Code Skill with one API key, or test the same model in the live generator below.
No OpenAI API key or separate OpenAI billing account is required.

Independent service · 2 credits per image · 3 signup credits · No card required

Live product

GPT Image 2 for Claude Live Generator

This is the real Claude Imagine generator, preselected to GPT Image 2 text-to-image. Enter a prompt, choose one of five aspect ratios, and generate with the same account balance used by MCP and the Claude Code Skill. The preview gallery offers prompt starters; your completed request returns its own model-generated image.

GPT Image 2 preselected2 credits per image1:1 · 4:3 · 3:4 · 16:9 · 9:16
Image Generator
Aspect Ratio
0 / 2000
Batch

Generate multiple images per click on Pro and Studio. Upgrade

Cost 2 creditsRemaining 0 credits

Tips for better results

  • Be specific about colors, lighting, and style
  • Mention art styles like "photorealistic", "anime", "oil painting"
  • Add quality keywords like "high resolution", "detailed"
Image Preview

Made with Claude Imagine — click a sample to try its prompt. Your result will appear here.

Three working paths

Set Up GPT Image 2 for Claude Code

Choose the route that matches where the output needs to land. Remote MCP is the shortest setup and keeps credentials out of your shell. The Skill saves the returned image into a local project. The HTTP API is the smallest building block for your own automation. All three call the same text-to-image service and share one Claude Imagine credit balance.

OAuth MCP

One Claude Code command

claude mcp add --transport http claude-imagine https://claudeimagine.com/api/mcp

Run the command once. Claude Code discovers OAuth 2.1, opens the browser login and consent screen, and registers generate_image, list_models, and get_credits. You paste no token into the MCP configuration.

Claude Code Skill

Save images into the repo

git clone https://github.com/lumian2015/nano-banana-claude-skill .claude/skills/nano-banana-claude
export CLAUDEIMAGINE_API_KEY="sk-..."
python3 .claude/skills/nano-banana-claude/scripts/generate.py "editorial product photo of a lime desk lamp" --model gpt-image-2 --aspect 16:9 --out hero.png

The public MIT Skill uses only Python's standard library. Create a Claude Imagine key once, then ask Claude Code for an image or call the script directly. The --out flag makes the destination explicit.

HTTP API

Call the generation endpoint

curl https://claudeimagine.com/api/v1/images/generations \
  -H "Authorization: Bearer $CLAUDEIMAGINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"editorial product photo of a lime desk lamp","aspect_ratio":"16:9"}'

POST a prompt, optional model, and optional aspect_ratio. A successful response contains image URLs, the friendly model id, and credits_used. The endpoint accepts text-to-image requests only.

Choose the Right GPT Image 2 for Claude Path

The model is the same; authentication, client support, and output handling are different. Pick the path by where you work rather than installing every option.

Remote MCP: least setup

Use MCP when the image should appear in the Claude conversation. OAuth connects your Claude Imagine account without exposing an API key, and Claude can check models and credits before it generates.

Claude Code Skill: local files

Use the Skill when Claude Code should write a PNG directly into a repository. The script accepts a model, aspect ratio, prompt, and output path, making it useful for web assets and documentation.

HTTP API: custom automation

Use the API when another script, agent, or backend owns the workflow. A bearer key authenticates the request, and the JSON response reports the exact model and credits consumed.

Web generator: visual control

Use the browser when you want a visible model selector, prompt starters, batch controls, task progress, downloads, and the image-to-image mode that the current MCP and public API do not expose.

One balance across every path

MCP, Skill, API, and web generations deduct from the same Claude Imagine credit ledger. A subscription grants recurring credits; a top-up pack adds one-time credits without changing your plan tier.

No silent model substitution

When you request gpt-image-2, the service maps that friendly id to the GPT Image 2 text-to-image implementation. If a request cannot start, it returns an error instead of quietly choosing another model.

From prompt to file

How GPT Image 2 for Claude Works

Claude remains the orchestrator and Claude Imagine remains the image service. Keeping those roles separate makes authentication, billing, and troubleshooting easier to understand.

1

Describe the asset

Tell Claude the subject, visual style, framing, lighting, aspect ratio, exact text, and constraints. Claude can turn that brief into the final prompt before it calls an external tool.

2

Select GPT Image 2

MCP accepts model gpt-image-2, the Skill uses --model gpt-image-2, and the API uses the same friendly id. The live generator exposes GPT Image 2 directly in its selector.

3

Generate through Claude Imagine

The service validates the prompt, account balance, concurrency limit, and aspect ratio, then creates a tracked image task. Two credits are deducted atomically for each started GPT Image 2 generation.

4

Receive or save the result

MCP returns the image URL to Claude, the API returns JSON, the Skill downloads the file to your chosen path, and the web generator displays a downloadable result in the task panel.

GPT Image 2 Credits, Plans, and Limits

Claude Imagine charges a predictable credit amount instead of passing through a separate OpenAI invoice. These values come from the live model catalog and billing code checked on August 24, 2026.

2 credits per image

A GPT Image 2 text-to-image request costs 2 Claude Imagine credits on free, Basic, Pro, and Studio accounts. Batch generation multiplies that amount by the number of images requested.

3 signup credits

A new account starts with 3 credits and needs no payment card. That is enough for one GPT Image 2 generation, with one credit left for a later Z-Image request.

Subscriptions recur

Monthly or annual subscriptions grant the plan's recurring credit allowance and plan benefits. Basic includes 450 monthly credits, Pro 1,300, and Studio 4,800 at the current monthly prices.

Top-up packs are one-time

A credit pack adds credits without creating a recurring subscription. It does not unlock Pro-only models because a pack buyer remains on the free plan tier, but GPT Image 2 itself is available.

Five aspect ratios

The public GPT Image 2 for Claude paths accept 1:1, 4:3, 3:4, 16:9, and 9:16. Unsupported values fail validation before an image task is created.

Plan-based concurrency

The live limits are one active generation on free accounts, two on Basic, three on Pro, and eight on Studio. A concurrency error does not silently queue an unlimited number of jobs.

What GPT Image 2 for Claude Does Not Mean

Clear boundaries matter more than feature inflation. The current public integrations deliberately expose a smaller, predictable surface than the web application.

Claude does not render the pixels

Claude writes or refines the prompt and invokes a connected tool. GPT Image 2 performs the image generation through Claude Imagine, so this is connected image generation rather than a native Claude raster model.

MCP, Skill, and API are text-to-image

The current generate_image MCP tool, public Skill script, and /api/v1/images/generations endpoint accept a text prompt. They do not accept an uploaded reference image for editing.

Web editing is separate

The Claude Imagine web generator exposes a GPT Image 2 image-to-image mode. Use that browser workflow when you need a reference image; do not assume the same input is available in MCP or the API.

API requests can outlive the wait

The HTTP endpoint waits up to 120 seconds. If generation is still running, it returns a 504 response that points you to Activity; the tracked task can still complete after the request stops waiting.

Task failures are refunded

When the image task reports a failed state, deducted credits are refunded automatically. A completed upstream task that returns no image URL is a separate support case and is reported explicitly.

Independent, not endorsed

Claude Imagine is an independent service and is not affiliated with, endorsed by, or sponsored by Anthropic or OpenAI. Claude and GPT Image are trademarks of their respective owners.

GPT Image 2 for Claude FAQ

Short answers based on the live Claude Imagine MCP, API, Skill, generator, pricing catalog, and credit ledger.









Need the raw endpoint instead? See the Claude Image Generation API quickstart.

Verify the Model and Claude Connection

Checked August 24, 2026. OpenAI documents GPT Image 2 generation and editing capabilities; Anthropic documents Claude's image understanding and remote MCP connectors. Claude Imagine product claims above are verified against the deployed code.

Generate Your First GPT Image 2 Asset from Claude

Connect with OAuth for the shortest path, or create one Claude Imagine key when the output needs to land directly in code. Your 3 signup credits are enough for one GPT Image 2 generation.