Skip to Content
Image ModelsMiniMax H3 Image

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/create

Headers

HeaderValueRequired
Content-Typeapplication/jsonYes
Api-Key{API_KEY}Yes

Request Parameters

ParameterTypeRequiredDescription
model_idstringYesUse 0-109 for both text-to-image and image-to-image.
promptstringYesNonempty generation or editing instructions, up to 5000 characters.
image_urlsarray of stringsConditionalProvide 1–10 publicly accessible HTTPS image URLs for image-to-image. Omit for text-to-image.
optionsobjectNoUses the defaults below when omitted.
options.resolutionstringNoDefaults to 2K. Supported values are 1K, 2K, and 4K.
options.aspect_ratiostringNoDefaults 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

ParameterTypeDescription
codeint1 for success, 0 for error.
messagestringSuccess or error message.
data.task_idstringTask identifier for querying results.
data.estimated_timeintEstimated 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