Generate images
minimax_create_imageGenerate 1-4 images on hailuoai.video with image-01, MiniMax H3 Image (h3-image, -highspeed), Nano Banana 2 / Pro, GPT Image 1.5 / 2, Seedream 4.5 / 5.0 or Midjourney V7 / Niji 7 (always 4), from a prompt and up to 16 reference images (referenceFileIdN, cited as @ImageN on models that support it) or a character image (characterFileId, image-01). Uses MiniMax credits per image. Waits up to ~50 s and returns each image's URL and fileID, the first as an image; else the imageIds for minimax_get_image. POST /images/create.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "minimax_create_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| model | No | Default image-01. | |
| prompt | Yes | What the image shows. Up to 2,000 characters (5,000 on Midjourney; 7,500 on h3-image, gpt-image-2 and Nano Banana). | |
| account | No | The account id from minimax_list_accounts. Optional with one account or when a reference fileID names it, required otherwise. | |
| quality | No | gpt-image-2 only: low (default), medium, high. | |
| quantity | No | Images to make, 1-4 (default 1; Midjourney always 4). Each image is charged. | |
| replyRef | No | Optional reference of yours, stored and returned with the result and webhook. Up to 1,024 characters. | |
| replyUrl | No | Optional webhook: the API POSTs the finished result (same shape as the get tool's record) to this URL. Up to 1,024 characters. | |
| resolution | No | By model: image-01 HD; h3-image*, gpt-image-2, nano-banana-pro 1K (default) / 2K / 4K; nano-banana-2 512P (default) / 1K / 2K / 4K; gpt-image-1.5 Low (default) / Medium / High; seedream-4.5 2K / 4K; seedream-5.0 2K / 3K; none on Midjourney. | |
| aspectRatio | No | Default auto (16:9 on image-01 and gpt-image-2, which take no auto). gpt-image-1.5: auto, 1:1, 3:2, 2:3 only; image-01: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9. | |
| characterFileId | No | image-01 only: a clear front-facing character photo: a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId1 | No | referenceFileId1: reference image 1, cited as @Image1 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId2 | No | referenceFileId2: reference image 2, cited as @Image2 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId3 | No | referenceFileId3: reference image 3, cited as @Image3 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId4 | No | referenceFileId4: reference image 4, cited as @Image4 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId5 | No | referenceFileId5: reference image 5, cited as @Image5 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId6 | No | referenceFileId6: reference image 6, cited as @Image6 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId7 | No | referenceFileId7: reference image 7, cited as @Image7 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId8 | No | referenceFileId8: reference image 8, cited as @Image8 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId9 | No | referenceFileId9: reference image 9, cited as @Image9 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId10 | No | referenceFileId10: reference image 10, cited as @Image10 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId11 | No | referenceFileId11: reference image 11, cited as @Image11 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId12 | No | referenceFileId12: reference image 12, cited as @Image12 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId13 | No | referenceFileId13: reference image 13, cited as @Image13 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId14 | No | referenceFileId14: reference image 14, cited as @Image14 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId15 | No | referenceFileId15: reference image 15, cited as @Image15 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| referenceFileId16 | No | referenceFileId16: reference image 16, cited as @Image16 where the model supports @-mentions; fill slots in order from 1 (up to 16 on h3-image / gpt-image-2, 14 on most, 3 on gpt-image-1.5; not image-01): a fileID from minimax_upload_file, minimax_list_files, minimax_list_characters or a completed image (minimax_get_image), on the same account. | |
| promptOptimization | No | Let MiniMax rewrite the prompt (default true). |