How to Use MiniMax Image-01 in VS 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 VS Code
Copy an example into VS 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.
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 VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - Sign in
VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.
Use the Spiral skill
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: VS 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.
Settings you can ask for
MiniMax Image-01 works from your prompt. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Aspect ratio | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, or 21:9 | 1:1 | Aspect ratio of the generated image |
| Number of images | 1 to 9 | 1 | Number of images to generate (1-9) |
| Prompt optimizer | on or off | off | 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 VS 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.
More on MiniMax Image-01 and VS Code
Overview
MiniMax Image-01 in other agents
Questions about MiniMax Image-01 in VS Code
Can VS Code use MiniMax Image-01?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run MiniMax Image-01 like any built-in tool.
How much does MiniMax Image-01 cost in VS 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 VS Code plan is separate.
Do I need a fal account to use MiniMax Image-01 in VS 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 VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while MiniMax Image-01 runs?
MiniMax Image-01 runs in the background. VS 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.
Start using MiniMax Image-01 in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


