MiniMax H3 Image API
Complete API reference for MiniMax H3 Image text-to-image and image editing models.
Model Variants
This API supports two model variants:
Quick Comparison
Supported Aspect Ratios
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Provide the ratio as separate numeric width and height values, not pixel dimensions. If both values are omitted, the ratio defaults to 1:1; otherwise, provide both values using one of the supported integer pairs.
MiniMax H3 Image (Text-to-Image)
Endpoint
POST /api/v1/image/task
Authentication
Authorization: Bearer YOUR_API_KEY
Request Parameters
Required
Optional
Note: The width:height ratio must be one of the 15 supported ratios listed above.
Example Request
javascript
MiniMax H3 Image Edit (Image Editing)
Endpoint
POST /api/v1/image/task
Request Parameters
Required
Optional
Note: The width:height ratio must be one of the 15 supported ratios listed above.
Example Request
javascript
Single Image Edit Example
javascript
Multi-Image Composition Example
javascript
Response Format
Initial Response
json
Polling Response
Poll GET /api/v1/image/{task_id} to check status. Successful polling responses expose generated image URLs under data.task_result.images[].url.
Status Values
submitted: Task acceptedprocessing: Image generation in progresssucceed: Image generation completedfailed: Image generation failed
Best Practices
- Detailed Prompts: Describe the subject, lighting, and composition, keeping prompts within 5000 characters
- Resolution Selection: Pass
1k,2k, or4kexplicitly in every request - Aspect Ratio: Use paired ratio values for
widthandheight, or omit both for1:1 - Image Edit Quality: Provide 1-16 reference images that meet the supported format and dimension requirements