MiniMax H3 Image
Overview
MiniMax H3 Image is an open-source image generation and editing model from MiniMax, part of the MiniMax H3 family. On Kie.ai it generates images at 1K, 2K or 4K (about 16 megapixels) in ten aspect ratios. It also edits images using up to 16 reference images.
Pixwith supports up to 10 reference images per edit.
Endpoints
1. Create Task
POST https://api.pixwithapi.online/api/task/createHeaders
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | Yes |
| Api-Key | {API_KEY} | Yes |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Yes | Use 0-109 for both text-to-image and image-to-image. |
| prompt | string | Yes | Nonempty generation or editing instructions, up to 5000 characters. |
| image_urls | array of strings | Conditional | Provide 1–10 publicly accessible HTTPS image URLs for image-to-image. Omit for text-to-image. |
| options | object | No | Uses the defaults below when omitted. |
| options.resolution | string | No | Defaults to 2K. Supported values are 1K, 2K, and 4K. |
| options.aspect_ratio | string | No | Defaults to 1:1 for text-to-image and Auto for image-to-image. Fixed ratios are 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, and 21:9. In image-to-image, Auto follows the first reference image. |
Example Request — Text-to-Image
{
"model_id": "0-109",
"prompt": "A ceramic coffee cup on a wooden table in soft morning light",
"options": {
"resolution": "2K",
"aspect_ratio": "4:3"
}
}Example Request — Image-to-Image
{
"model_id": "0-109",
"prompt": "Place the coffee cup from <Picture 1> on the table in <Picture 2>",
"image_urls": [
"https://cdn.pixwithapi.online/example-1.jpg",
"https://cdn.pixwithapi.online/example-2.png"
],
"options": {
"resolution": "4K",
"aspect_ratio": "Auto"
}
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | int | 1 for success, 0 for error. |
| message | string | Success or error message. |
| data.task_id | string | Task identifier for querying results. |
| data.estimated_time | int | Estimated generation time in seconds. |
Example Response
{
"code": 1,
"message": "success",
"data": {
"task_id": "d425ab4dc256f0ebaa84862b9cea8a3d",
"estimated_time": 70
}
}Use the returned task_id with Get Task Results to check status and retrieve the image.
Last updated on