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

Codex · ImageReleased 2025-02-15

How to Use MiniMax Image-01 in Codex

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 Codex

Copy an example into Codex, 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-01Codex
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 Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. Sign in

    Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.

    codex mcp login spiral

Use the Spiral skill

  1. Send Codex 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: Codex 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 Codex 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 Codex?

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 Codex

Can Codex use MiniMax Image-01?

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

How much does MiniMax Image-01 cost in Codex?

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

Do I need a fal account to use MiniMax Image-01 in Codex?

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 Codex?

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

Does Codex wait while MiniMax Image-01 runs?

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

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

Paste this into Codex:

Set up Codex

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