MiniMax h3 Image
minimax-h3-imageGenerate 1K, 2K, or 4K images from text or up to 16 reference images with MiniMax H3 Image. Turn a product photo, room image, or layout sketch into a new composition, or describe a focused edit while preserving the surrounding scene. Use it to draft campaign posters, compare product materials, and explore illustrated layouts or alternative styles for the same subject. Review lettering, textures, and composition before using the result in a final design. The model page includes request examples, parameters, and pricing references.
- Published price
- From $0.010 / image
- Billing unit
- / image
- Context / Max output
- — / —
- Listed routes
- 1
Create one image from a text brief.
Output settings
Result preview
yir · 333ms
This example shows the response structure. Generated images appear here after the run completes.
{
"id": "YOUR_TASK_ID",
"model": "minimax/minimax-h3-image",
"object": "job",
"status": "queued",
"parameters": {
"n": 1,
"resolution": "4K",
"aspect_ratio": "1:1"
}
}- Base URL
https://api.openany.si/v1- POST
/v1/images- GET
/v1/images/{task_id}- Authentication
Authorization: Bearer $OPENANY_API_KEY
Request parameters
| Parameter | Type / range | Default value | Required | Description |
|---|---|---|---|---|
prompt | string | Create an illustrated field-guide poster titled FOREST NOTES. Show a fox, pine branches, a folded trail map, and three clearly separated detail panels. Use readable short English labels, muted green ink, warm ivory paper, and a balanced editorial layout. | Yes | Describe the full scene, exact short text, and details to preserve. Maximum 20,000 characters on this public route. |
resolution | string · 1K | 2K | 4K | 4K | No | Choose 1K, 2K, or 4K. Default: 4K. |
aspect_ratio | string · 1:1 | 2:3 | 3:2 | 3:4 | 4:3 | 4:5 | 5:4 | 9:16 | 16:9 | 21:9 | 1:1 | No | Choose the output framing. Default: 1:1. |
size | string · 1024x1024 | 832x1248 | 1248x832 | 896x1184 | 1184x896 | 928x1152 | 1152x928 | 768x1376 | 1376x768 | 1568x672 | 2048x2048 | 1664x2496 | 2496x1664 | 1760x2368 | 2368x1760 | 1824x2304 | 2304x1824 | 1536x2720 | 2720x1536 | 3136x1344 | 4096x4096 | 3328x4992 | 4992x3328 | 3520x4704 | 4704x3520 | 3648x4576 | 4576x3648 | 3072x5440 | 5440x3072 | 6240x2656 | | No | Leave blank to use resolution and aspect_ratio. Exact pixels must match both selections and may limit eligible channels; refer to the size table in Overview. |
n | integer · 1 1 ~ 1 | 1 | No | This public model contract generates one image per job. Submit separate jobs for additional outputs. |
Request example
curl 'https://api.openany.si/v1/images' \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Create an illustrated field-guide poster titled FOREST NOTES. Show a fox, pine branches, a folded trail map, and three clearly separated detail panels. Use readable short English labels, muted green ink, warm ivory paper, and a balanced editorial layout.",
"type": "text"
},
"model": "minimax-h3-image",
"parameters": {
"aspect_ratio": "1:1",
"n": 1,
"resolution": "4K",
"size": ""
},
"route_mode": "balanced"
}'Response example
Configured response example · not a live result
{
"id": "YOUR_TASK_ID",
"model": "minimax/minimax-h3-image",
"object": "job",
"status": "queued",
"parameters": {
"n": 1,
"resolution": "4K",
"aspect_ratio": "1:1"
}
}Error handling
400Check the model ID and request fields.429Retry with exponential backoff.5xxRetry only temporary provider failures.JSON Schema
{
"type": "object",
"required": [
"model",
"input",
"parameters"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"prompt"
],
"properties": {
"type": {
"type": "string",
"const": "text"
},
"prompt": {
"type": "string",
"pattern": "\\S",
"maxLength": 20000,
"minLength": 1,
"description": "Describe the image or editing instructions. This public Standard input allows up to 20,000 characters."
}
},
"additionalProperties": false
},
"model": {
"type": "string",
"const": "minimax-h3-image"
},
"route": {
"type": "object",
"properties": {
"provider": {
"const": "yir"
}
}
},
"parameters": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"size"
]
},
"then": {
"oneOf": [
{
"properties": {
"size": {
"const": "1024x1024"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "1:1"
}
}
},
{
"properties": {
"size": {
"const": "832x1248"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "2:3"
}
}
},
{
"properties": {
"size": {
"const": "1248x832"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "3:2"
}
}
},
{
"properties": {
"size": {
"const": "896x1184"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "3:4"
}
}
},
{
"properties": {
"size": {
"const": "1184x896"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "4:3"
}
}
},
{
"properties": {
"size": {
"const": "928x1152"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "4:5"
}
}
},
{
"properties": {
"size": {
"const": "1152x928"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "5:4"
}
}
},
{
"properties": {
"size": {
"const": "768x1376"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "9:16"
}
}
},
{
"properties": {
"size": {
"const": "1376x768"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "16:9"
}
}
},
{
"properties": {
"size": {
"const": "1568x672"
},
"resolution": {
"const": "1K"
},
"aspect_ratio": {
"const": "21:9"
}
}
},
{
"properties": {
"size": {
"const": "2048x2048"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "1:1"
}
}
},
{
"properties": {
"size": {
"const": "1664x2496"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "2:3"
}
}
},
{
"properties": {
"size": {
"const": "2496x1664"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "3:2"
}
}
},
{
"properties": {
"size": {
"const": "1760x2368"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "3:4"
}
}
},
{
"properties": {
"size": {
"const": "2368x1760"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "4:3"
}
}
},
{
"properties": {
"size": {
"const": "1824x2304"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "4:5"
}
}
},
{
"properties": {
"size": {
"const": "2304x1824"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "5:4"
}
}
},
{
"properties": {
"size": {
"const": "1536x2720"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "9:16"
}
}
},
{
"properties": {
"size": {
"const": "2720x1536"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "16:9"
}
}
},
{
"properties": {
"size": {
"const": "3136x1344"
},
"resolution": {
"const": "2K"
},
"aspect_ratio": {
"const": "21:9"
}
}
},
{
"properties": {
"size": {
"const": "4096x4096"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "1:1"
}
}
},
{
"properties": {
"size": {
"const": "3328x4992"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "2:3"
}
}
},
{
"properties": {
"size": {
"const": "4992x3328"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "3:2"
}
}
},
{
"properties": {
"size": {
"const": "3520x4704"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "3:4"
}
}
},
{
"properties": {
"size": {
"const": "4704x3520"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "4:3"
}
}
},
{
"properties": {
"size": {
"const": "3648x4576"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "4:5"
}
}
},
{
"properties": {
"size": {
"const": "4576x3648"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "5:4"
}
}
},
{
"properties": {
"size": {
"const": "3072x5440"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "9:16"
}
}
},
{
"properties": {
"size": {
"const": "5440x3072"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "16:9"
}
}
},
{
"properties": {
"size": {
"const": "6240x2656"
},
"resolution": {
"const": "4K"
},
"aspect_ratio": {
"const": "21:9"
}
}
}
]
}
}
],
"properties": {
"n": {
"enum": [
1
],
"type": "integer",
"default": 1,
"description": "One output per job. Submit separate jobs for more outputs."
},
"size": {
"enum": [
"1024x1024",
"832x1248",
"1248x832",
"896x1184",
"1184x896",
"928x1152",
"1152x928",
"768x1376",
"1376x768",
"1568x672",
"2048x2048",
"1664x2496",
"2496x1664",
"1760x2368",
"2368x1760",
"1824x2304",
"2304x1824",
"1536x2720",
"2720x1536",
"3136x1344",
"4096x4096",
"3328x4992",
"4992x3328",
"3520x4704",
"4704x3520",
"3648x4576",
"4576x3648",
"3072x5440",
"5440x3072",
"6240x2656"
],
"type": "string",
"description": "Optional exact output pixels. Requires a compatible channel and matching resolution and aspect_ratio."
},
"resolution": {
"enum": [
"1K",
"2K",
"4K"
],
"type": "string",
"default": "4K",
"description": "Output resolution. The public default is 4K."
},
"aspect_ratio": {
"enum": [
"1:1",
"2:3",
"3:2",
"3:4",
"4:3",
"4:5",
"5:4",
"9:16",
"16:9",
"21:9"
],
"type": "string",
"default": "1:1",
"description": "Output aspect ratio."
}
},
"additionalProperties": false
},
"route_mode": {
"type": "string",
"default": "balanced"
}
}
}Request example
POST /v1/imagescurl 'https://api.openany.si/v1/images' \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Create an illustrated field-guide poster titled FOREST NOTES. Show a fox, pine branches, a folded trail map, and three clearly separated detail panels. Use readable short English labels, muted green ink, warm ivory paper, and a balanced editorial layout.",
"type": "text"
},
"model": "minimax-h3-image",
"parameters": {
"aspect_ratio": "1:1",
"n": 1,
"resolution": "4K",
"size": ""
},
"route_mode": "balanced"
}'Model API questions
How do I call MiniMax h3 Image through OpenAny?
Use model ID minimax-h3-image with an OpenAny key and the operation published in this model's API tab. The model API base is https://api.openany.si/v1. Confirm the protocol and request schema; model availability does not imply every OpenAI API operation is supported.
How is MiniMax h3 Image billed?
Compare the published rate and billing unit of the selected provider route. Input, output and cache token rates may differ. Image, audio and video models can use other units. Recorded usage determines the charge under that route's billing contract.
Are Community and Verified routes the same as an official publisher API?
No. Inspect the provider name and supply classification for the specific route. A marketplace listing or a supply label is not a claim of publisher endorsement, identical service or measured uptime. Different route prices may reflect different supply and conditions.
Where do these prices come from, and when were they updated?
Rates come from the provider routes in OpenAny's public model catalog, not an independent quote from the model publisher. The catalog does not supply a price update timestamp. A page or catalog snapshot date is not a price revision date. Compare supply, billing units, tiers and conditions; a lower listed rate alone does not establish equivalent service or explain the price difference.
Use MiniMax h3 Image with your agent
Inspect endpoint contracts and confirm availability and pricing before a paid call.