MiniMax H3 Text-to-Image
POST
/api/v1/jobs/createTask
expand_prompt: true); turn it off to use your prompt as-is, which is 10–20 seconds faster.Output size
resolution (default 2K) sets the size tier and aspect_ratio sets the shape. auto lets the prompt rewriter choose the ratio based on your content (falls back to 1:1 when expand_prompt is false).| Aspect ratio | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
| 5:4 / 4:5 | 1152×912 / 912×1152 | 2304×1824 / 1824×2304 | 4576×3648 / 3648×4576 |
| 4:3 / 3:4 | 1184×880 / 880×1184 | 2368×1760 / 1760×2368 | 4736×3552 / 3552×4736 |
| 3:2 / 2:3 | 1248×832 / 832×1248 | 2496×1664 / 1664×2496 | 5024×3360 / 3360×5024 |
| 16:9 / 9:16 | 1360×768 / 768×1360 | 2720×1536 / 1536×2720 | 5472×3072 / 3072×5472 |
| 21:9 | 1568×672 | 3136×1344 | 6272×2688 |
width and height in pixels (1–8192 each), e.g. width: 1920, height: 1080. Total pixels 655,360–20,000,000, width : height between 1:3 and 3:1; the output is exactly this size. When using them, do not pass resolution or aspect_ratio — the upstream does not accept that combination.| You pass | Output size and billing tier |
|---|---|
Both width and height (and no resolution / aspect_ratio) | Output is width × height, billed by total pixels (≤ 1.2 MP → 1K, ≤ 4.5 MP → 2K, otherwise 4K) |
| Only one of them | Not allowed: width and height must be set together |
| Neither | resolution (default 2K) and aspect_ratio (default auto) apply |
width/height together with resolution or aspect_ratio | Not allowed: the upstream rejects the request |
1K / 2K / 4K): from width × height when both are set, otherwise from resolution; the tier does not depend on the ratio chosen by auto. For current prices, see kie.ai/pricingQuery Task Status
model=minimax-h3/text-to-image, use the unified query endpoint to check progress and retrieve results:callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.Related Resources
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "minimax-h3/text-to-image",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "A cozy bookstore cafe on a rainy evening, warm lights glowing through the window, a ginger cat sleeping on a stack of books",
"aspect_ratio": "16:9",
"resolution": "2K",
"output_format": "png"
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_minimax_h3_1786417000000"
}
}