Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · ImageReleased 2026-11-10

How to Use MiniMax H3 Image Edit in Claude Code

MiniMax H3 Image Edit reworks photos, combines visual references, and changes specific details through text instructions. Unlike MiniMax H3 Image Text to Image, it starts from existing images and can combine up to 16 references.

Prompts to try with MiniMax H3 Image Edit in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use MiniMax H3 Image Edit with the product photograph in assets as Picture 1. Change only the mug's body color to forest green; preserve its shape, handle, material, position, background, and camera angle. Return a 4096 × 4096 image.

MiniMax H3 Image EditClaude Code
Try asking
  • Use MiniMax H3 Image Edit to develop a packaging concept from the existing carton image as Picture 1 and the palette image as Picture 2. Borrow only the colors from Picture 2. Preserve the carton's geometry and replace the front label with 'Night roast' above 'Whole bean coffee'; add no other copy.

  • Remove the background from the photo I attach with MiniMax H3 Image Edit and give me a transparent PNG. Save the result in ./assets.

  • Use MiniMax H3 Image Edit to clean up these product shots so they sit on pure white.

  • Edit this image with MiniMax H3 Image Edit: keep the subject, swap the background for a sunlit studio.

How to set up MiniMax H3 Image Edit in Claude Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run MiniMax H3 Image Edit

    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": "minimax/h3-image/edit",
        "input": {
          "prompt": "Put a red knitted scarf on the dog and keep everything else",
          "image_urls": [
            "<image_urls>"
          ]
        }
      }'

Then paste one of the prompts above: Claude Code finds MiniMax H3 Image Edit on Spiral, shows the price and runs it.

MiniMax H3 Image Edit providers and prices

Spiral runs MiniMax H3 Image Edit through fal. Open a card for today's price, with every fee included.

falImage
MiniMax H3 Image Edit
minimax/h3-image/edit

Settings you can ask for

MiniMax H3 Image Edit works from your prompt and image URLs. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Number of images1 to 101

The number of images to generate, all from one expanded prompt.

Output formatjpeg, png, webp, or jpgpng

The format of the generated image.

Every API field of MiniMax H3 Image Edit is on its tool page: open its card above.

What can you do with MiniMax H3 Image Edit in Claude Code?

Create artwork and visual design studies alongside the project that needs them. A coding agent can use project briefs and existing assets to specify composition, materials, and exact copy for MiniMax H3 Image.

Game cover and store artwork

Bring a character, setting, and lighting direction together in one image for a game cover or store banner. Specify the subject placement and leave deliberate space for the title.

Character reference sheets

Explore a character's silhouette, clothing, expressions, and proportions in a sheet with explicitly defined rows and columns. Check that the requested details agree across views.

Packaging concepts

Explore a coordinated packaging design for several products. Supply the complete product names and label copy, then define which colors and graphics distinguish each product.

Editorial image concepts

Turn an abstract article theme into a concrete photographic scene. Describe the subject, scale, viewpoint, light, and materials so the visual idea is easy to assess.

Book and card illustrations

Develop cover art or illustrated cards with specified linework, texture, colors, and recurring motifs. State whether lettering belongs in the artwork or will be added later.

Mechanical design studies

Explore vehicle, machine, or product shapes through multiple views and concept diagrams. Define the visible components and treat the result as a design study for review.

Furniture placement from references

Combine a room photograph with furniture references to explore a furnished composition. Assign each reference a role and specify which colors, materials, and proportions should carry through.

Focused photo revisions

Change a named object's color, revise the lighting, or replace an element in an existing scene. Describe the finished change and explicitly identify the content that should stay the same.

Questions about MiniMax H3 Image Edit in Claude Code

Can Claude Code use MiniMax H3 Image Edit?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run MiniMax H3 Image Edit like any built-in tool.

How much does MiniMax H3 Image Edit cost in Claude Code?

Up to $0.1456 per run at the default inputs. $0.1456 per unit of `num_images`. Each item in `image_urls` adds $0.0104. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need a fal account to use MiniMax H3 Image Edit in Claude Code?

No. Spiral runs MiniMax H3 Image Edit on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up MiniMax H3 Image Edit in Claude Code?

About two minutes: add the hosted server, then sign in.

Does Claude Code wait while MiniMax H3 Image Edit runs?

MiniMax H3 Image Edit runs in the background. Claude Code starts the run, checks on it and gives you the image when it's ready.

What is MiniMax H3 Image good at?

MiniMax H3 Image suits detailed scenes, realistic textures, illustrations, and compositions with specific spatial instructions. MiniMax demonstrates uses including game art, character sheets, packaging, and product diagrams.

What resolution should I use for a detailed final image?

MiniMax recommends about 16 megapixels for best results. Examples include 4096 × 4096 for a square and 5472 × 3072 for a wide landscape.

Can MiniMax H3 Image put readable text in an image?

MiniMax provides guidance for posters, labels, charts, and other images containing text. Quote the exact wording, specify its position and line breaks, and check the rendered copy against your brief.

How should I structure a MiniMax H3 Image prompt?

Start with the intended image and its purpose, then specify the layout, subject positions, and visible details. MiniMax recommends writing the image description in English while keeping any visible lettering in its intended language.

Can MiniMax H3 Image produce a transparent background?

Transparent backgrounds are not supported. MiniMax also lists masked edits and preview images as unsupported.

Get started

Start using MiniMax H3 Image Edit in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options