About MiniMax H3-Image
MiniMax H3-Image is MiniMax's image model, released in November 2026. This is MiniMax's hosted version: it makes pictures at 1K, 2K or 4K and edits with one to sixteen source pictures, which you name in the prompt as image 1, image 2 and so on.
Call it with the model name minimax/h3-image/edit on POST /jobs/createTask, from $0.0456.
Introduction
Supply image_urls and a prompt to revise a picture or combine several references using MiniMax H3-Image.
Key features
An edit can use up to sixteen pictures; refer to each with image and its upload number. In our tests the room composition retained its window lighting.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 |
image_urls | Yes | Photos to edit or combine. Say in the prompt what each one adds. |
output_format | No | File type of the result. jpeg · png · webp · Default: png |
prompt | Yes | Describe what you want to make. |
resolution | No | Choose an available output size. 1k · 2k · 4k · Default: 1k |
Pricing
Prices are in USD and charged to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per image |
|---|---|
| resolution 1K | $0.036 |
| resolution 2K | $0.036 |
| resolution 4K | $0.108 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
Use cases
Try furnishing an interior, moving a chef to a market stall or recoloring a sneaker while naming what should remain.
Prompt guide & pro tips
Assign a role to every uploaded image and state the parts of the scene to preserve. Without aspect_ratio, the model picks the output shape from the inputs and request.
API quick start
Call the MiniMax H3-Image API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls are billed in USD from your PopNow balance.
- Send the request. POST /jobs/createTask with model minimax/h3-image/edit and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "1k",
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
MiniMax H3-Image API questions
How much does the MiniMax H3-Image API cost?
MiniMax H3-Image starts at $0.0456 per image with Edit Image, its lowest-priced task. Prices by option: 1K $0.036 per image, 2K $0.036 per image, 4K $0.108 per image. API usage is charged in USD to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What are the limits of the MiniMax H3-Image · Edit Image API?
Resolutions: 1K · 2K · 4K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Reference images: 16; Prompt length (characters): 5,000; Largest upload: 10 MB. Requests outside these limits are rejected before anything is charged.
More about MiniMax H3-Image
- Endpoints
- MiniMax H3-Image · Create Image