MiniMax Image-01 Guide: Hailuo Image Generation with an API

MiniMax Image-01 is MiniMax's hosted text-to-image model. To generate an image, send a prompt with the model identifier image-01 to MiniMax's image-generation API; a character reference is optional. Its launch announcement connects Image-01's development to MiniMax's Hailuo Video-01 work. Announcement Guide API

No open weights are provided for Image-01 in these sources. Access it as a service, with an account, API credentials, and requests to MiniMax's infrastructure.

What are the key facts about MiniMax Image-01?

Use the API identifier image-01 when implementing an integration. Keeping the product name and request identifier together helps avoid confusion when a project also uses other MiniMax services. API reference

What can MiniMax Image-01 generate from prompts and references?

MiniMax's launch examples emphasize scene composition, lighting, human subjects, and objects. Those examples establish the intended uses; they are not a substitute for evaluating the model on your own creative brief. Announcement

For a useful trial, choose a scene whose success you can describe concretely. A product on a plain surface is easier to assess than an open-ended request for something impressive.

List the object's material, camera position, surroundings, and lighting direction. Then inspect whether the result communicates those choices. This turns a subjective browsing session into a focused production exercise.

The official guide also documents generating a new image from a subject reference and a prompt. It describes preserving the subject's key characteristics across different contexts. Reference workflow

That makes character continuity a reasonable thing to test. Use the same reference while changing the background, then compare the visible identity details before accepting an image into a series.

Do not judge character continuity only from thumbnails. Inspect facial features, clothing, and silhouette at the intended delivery size. The documented reference type is character; the guide does not establish a separate product-reference mode. Reference workflow

What are MiniMax Image-01 prompt, batch, and output limits?

The API caps prompts at 1,500 characters and supports requests for one to nine images. Returned image URLs expire after 24 hours. Request limits

Choose either an aspect-ratio preset or custom dimensions deliberately. The reference says an aspect ratio takes priority when both are provided, so an unnoticed preset can change the expected output shape. API reference

The reference-image guide supports one reference image per request. It describes subject-guided generation; do not assume that it provides every control found in a dedicated image editor. Guide

Neither the launch post nor these instructions establish a universal consumer-GPU memory requirement for Image-01. Your computer sends requests to a hosted model, so local checkpoint sizing is not the setup task.

A batch request also needs a result check. The response example includes metadata.success_count, metadata.failed_count, and base_resp.status_code; inspect those fields and the returned images before displaying a completed gallery. API reference

How do you call the MiniMax Image-01 API?

1. Create a MiniMax platform account and obtain an API key using the account link in the reference. API
2. Set MINIMAX_API_KEY in the environment used by your client.
3. Start with a single image request and a clearly described subject.
4. Check the response status and save the returned image.
5. Add reference inputs only after the basic path works.

The following original prompt uses MiniMax's documented JSON request format. It prints the response so you can inspect the image URL and status fields. API

curl --fail-with-body https://api.minimax.io/v1/image_generation \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "A ceramic teapot on a pale wooden table, soft window light, uncluttered background",
    "aspect_ratio": "1:1",
    "response_format": "url",
    "n": 1
  }'

Keep a record of the prompt and settings alongside the downloaded file. When reviewing a variation, annotate the specific failure rather than using a general label such as low quality.

For example, distinguish an incorrect object shape from an unwanted background. Those observations suggest different prompt revisions and make later comparisons more useful.

The official guide offers a base64 response example if you prefer to decode image data directly. Follow that example when your application needs to write an output file immediately. Saving outputs

For the reference workflow, use the documented subject_reference structure with a character image. Keep the reference constant during an evaluation so the changing scene is the main variable. Guide

A practical prompt log can contain the scene description, reference filename, selected settings, and acceptance notes. Build that habit before introducing a large batch or a more elaborate interface.

Find starting structures in PromptZone's prompt library, then rewrite them around the object and composition you can actually evaluate.

How does MiniMax Image-01 compare with Ideogram and local FLUX?

Ideogram 3.0 is another hosted image model with documented style controls. Compare it with Image-01 when the task depends on visual treatment, and use MiniMax's subject-reference path when testing character continuity. Ideogram API

FLUX.1-schnell offers downloadable weights and a documented local workflow. That is a different deployment choice from sending requests to MiniMax. FLUX model card

These options do not establish a quality winner. Choose a shared brief and judge the resulting assets using the same acceptance rules.

The ComfyUI pillar explains the local workflow context if deployment control is part of your decision.

What else should you know about MiniMax Image-01?

Is Hailuo Image a downloadable model?

MiniMax documents Image-01 as a hosted API service and provides no open weights in the cited release materials. Use the image-01 API identifier for the image-generation workflow. Guide Announcement

Can Image-01 work from a reference image?

MiniMax Image-01 accepts one subject-reference image per request. The guide demonstrates the character reference type for generating the same subject in different settings. Guide

Can I keep the returned image URL permanently?

MiniMax Image-01 image URLs expire after 24 hours. Download the file for storage, or use the documented base64 response option. API

Is batch generation the same as predictable throughput?

MiniMax Image-01's batch-size allowance does not specify a fixed completion time. Measure the time and accepted output count for your own workload before planning a production schedule. API

Sources

• MiniMax Image-01 launch announcement
• MiniMax model release notes
• MiniMax image-generation guide
• MiniMax text-to-image API reference
• Ideogram 3.0 generation reference
• FLUX.1-schnell official model card

Related guides on PromptZone

• Best SDXL Models in 2026
• ComfyUI 2026: The Complete Guide
• AI Model Releases Timeline