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

Claude Code · ImageReleased 2025-02-15

How to Use MiniMax Image-01 in Claude Code

MiniMax Image-01 turns detailed text descriptions into portraits, product concepts, and scenes with nuanced lighting. Use it when skin texture, material detail, and environmental composition matter.

Prompts to try with MiniMax Image-01 in Claude Code

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

Read the homepage brief in this project and use MiniMax Image-01 to create a 16:9 hero image. Describe a concrete scene that matches the brief, position the subject on the right, and leave open space on the left for our HTML headline.

MiniMax Image-01Claude Code
Try asking
  • Read the product concept document and use MiniMax Image-01 to create a square studio image of the proposed desk lamp. Include the documented materials, a three-quarter view, soft side lighting, and a plain backdrop.

  • Use the article draft in this project to write a visual description under 1,500 characters, then generate a 4:3 illustration with MiniMax Image-01. Show one concrete scene that explains the article's central idea.

  • Read our game's location notes and use MiniMax Image-01 to create a 21:9 environment concept. Describe the foreground, middle distance, weather, and light direction; keep the image description under 1,500 characters.

  • Read the design brief and use MiniMax Image-01 to generate a 3:4 fictional editorial portrait for the demo. Match the described wardrobe and setting, with a natural expression and soft window light.

How to set up MiniMax Image-01 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 Image-01

    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": "fal-ai/minimax/image-01",
        "input": {
          "prompt": "Man dressed in white t shirt, full-body stand front view image, outdoor, Venice beach sign, full-body image, Los Angeles, Fashion photography of 90s,…"
        }
      }'

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

MiniMax Image-01 providers and prices

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

falImage
MiniMax (Hailuo AI) Text to Image
fal-ai/minimax/image-01

Settings you can ask for

MiniMax Image-01 works from your prompt. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Aspect ratio1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, or 21:91:1

Aspect ratio of the generated image

Number of images1 to 91

Number of images to generate (1-9)

Prompt optimizeron or offoff

Whether to enable automatic prompt optimization

Every API field of MiniMax (Hailuo AI) Text to Image is on its tool page: open its card above.

What can you do with MiniMax Image-01 in Claude Code?

Turn project briefs into image assets for website layouts and content previews. Have the coding agent extract a concrete visual description from your files, then generate portraits, objects, or environments for review.

Product photography concepts

Explore a ceramic mug, metal watch, or glass bottle in a described studio setting. Specify surface texture, reflections, camera angle, and lighting.

Editorial portraits

Create fictional portrait concepts with a clear expression, wardrobe, setting, and light direction. Describe the skin texture and framing you want.

Article illustrations

Turn an article's central idea into a concrete scene, such as a gardener inspecting dry soil or a cyclist repairing a wheel.

Website hero imagery

Draft a landscape scene with the subject positioned to leave room for a headline. Describe foreground objects, background depth, and the light source.

Interior design concepts

Explore a room through furniture placement, wood grain, fabric texture, and daylight. Use the images to discuss a visual direction.

Film scene planning

Create still concepts for a described location or dramatic moment. Define the shot framing, character placement, weather, and lighting.

Social post artwork

Draft vertical or square scenes around a specific subject, such as a seasonal meal or a quiet morning routine. Keep the composition focused on the intended message.

Material and lighting studies

Explore how a described object might look in ceramic, glass, or metal under different lighting directions. Change one detail between briefs to make comparison easier.

Questions about MiniMax Image-01 in Claude Code

Can Claude Code use MiniMax Image-01?

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

How much does MiniMax Image-01 cost in Claude Code?

$0.013 per image. Billed on `num_images`, default 1. 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 Image-01 in Claude Code?

No. Spiral runs MiniMax Image-01 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 Image-01 in Claude Code?

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

Does Claude Code wait while MiniMax Image-01 runs?

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

What is MiniMax Image-01 good at?

Consider it for portraits, product concepts, and detailed environments. MiniMax highlights skin texture, natural expressions, materials, and lighting as strengths.

What resolution does MiniMax Image-01 produce?

MiniMax documents 1024×1024 for square images, 1280×720 for widescreen, 720×1280 for vertical images, and 1344×576 for ultrawide images. Choose the composition around the intended placement.

How long can a MiniMax Image-01 prompt be?

The limit is 1,500 characters. For a long brief, keep the subject, composition, materials, lighting, and visual style in the final description.

How should I prompt MiniMax Image-01?

Use a detailed description instead of a few broad adjectives; the documentation recommends longer prompts. A useful structure is subject, setting, framing, lighting, materials, and style, kept within 1,500 characters.

How should I describe lighting and materials?

Specify concrete details such as side lighting on brushed steel, soft window light on skin, or warm reflections on ceramic. These are practical ways to use the lighting and material strengths MiniMax describes.

Get started

Start using MiniMax Image-01 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