[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [MiniMax Image-01](https://spiral.ai/integrations/gemini-cli/minimax-image-01)

# How to Use MiniMax Image-01 in Gemini CLI

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.

|  |  |
| --- | --- |
| Model | MiniMax Image-01 |
| Available through | fal |
| Category | Image |
| Price | $0.013 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with MiniMax Image-01 in Gemini CLI

- 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.
- 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 Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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.

```bash
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.

```bash
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: Gemini CLI finds MiniMax Image-01 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## MiniMax Image-01 tools and prices

- [MiniMax (Hailuo AI) Text to Image](https://spiral.ai/tools/fal/fal-ai/minimax/image-01) (fal): $0.013 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| aspect_ratio | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9 | 1:1 | Aspect ratio of the generated image |
| num_images | 1 to 9 | 1 | Number of images to generate (1-9) |
| prompt_optimizer |  | false | Whether to enable automatic prompt optimization |

## What can you do with MiniMax Image-01 in Gemini CLI?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## MiniMax Image-01 in other agents

- [Amp](https://spiral.ai/integrations/amp/minimax-image-01)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/minimax-image-01)
- [Claude](https://spiral.ai/integrations/claude-desktop/minimax-image-01)
- [Claude Code](https://spiral.ai/integrations/claude-code/minimax-image-01)
- [Cline](https://spiral.ai/integrations/cline/minimax-image-01)
- [Codex](https://spiral.ai/integrations/codex/minimax-image-01)
- [Cursor](https://spiral.ai/integrations/cursor/minimax-image-01)
- [Devin](https://spiral.ai/integrations/devin/minimax-image-01)
- [dots](https://spiral.ai/integrations/dots/minimax-image-01)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/minimax-image-01)
- [Gemini](https://spiral.ai/integrations/gemini/minimax-image-01)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/minimax-image-01)
- [goose](https://spiral.ai/integrations/goose/minimax-image-01)
- [Grok](https://spiral.ai/integrations/grok/minimax-image-01)
- [Grok Build](https://spiral.ai/integrations/grok-build/minimax-image-01)
- [Hermes](https://spiral.ai/integrations/hermes/minimax-image-01)
- [Instinct](https://spiral.ai/integrations/instinct/minimax-image-01)
- [Manus](https://spiral.ai/integrations/manus/minimax-image-01)
- [Muse](https://spiral.ai/integrations/muse/minimax-image-01)
- [Muse Code](https://spiral.ai/integrations/muse-code/minimax-image-01)
- [n8n](https://spiral.ai/integrations/n8n/minimax-image-01)
- [Notion](https://spiral.ai/integrations/notion/minimax-image-01)
- [OpenClaw](https://spiral.ai/integrations/openclaw/minimax-image-01)
- [opencode](https://spiral.ai/integrations/opencode/minimax-image-01)
- [Perplexity](https://spiral.ai/integrations/perplexity/minimax-image-01)
- [Raycast](https://spiral.ai/integrations/raycast/minimax-image-01)
- [VS Code](https://spiral.ai/integrations/vscode/minimax-image-01)
- [Windsurf](https://spiral.ai/integrations/windsurf/minimax-image-01)
- [Zapier](https://spiral.ai/integrations/zapier/minimax-image-01)

## More Gemini CLI guides

- [MiniMax H3 Image Text to Image](https://spiral.ai/integrations/gemini-cli/minimax-h3-image-text-to-image)
- [MiniMax Image-01 Subject Reference](https://spiral.ai/integrations/gemini-cli/minimax-image-01-subject-reference)
- [MiniMax H3 Image Highspeed Text to Image](https://spiral.ai/integrations/gemini-cli/minimax-h3-image-highspeed-text-to-image)
- [Muse Image Edit](https://spiral.ai/integrations/gemini-cli/muse-image-edit)
- [MiniMax H3 Image Highspeed Edit](https://spiral.ai/integrations/gemini-cli/minimax-h3-image-highspeed-edit)
- [Muse Image Text to Image](https://spiral.ai/integrations/gemini-cli/muse-image-text-to-image)

## Questions about MiniMax Image-01 in Gemini CLI

**Can Gemini CLI use MiniMax Image-01?**

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

**How much does MiniMax Image-01 cost in Gemini CLI?**

$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 Gemini CLI plan is separate.

**Do I need a fal account to use MiniMax Image-01 in Gemini CLI?**

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 Gemini CLI?**

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

**Does Gemini CLI wait while MiniMax Image-01 runs?**

MiniMax Image-01 runs in the background. Gemini CLI 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.

