MiniMax H3 Image Edit
Edit a reference image or combine multiple reference images with MiniMax H3 to generate one image per request. Provide an editing prompt and 1–16 publicly downloadable reference image URLs; use <Picture 1>, <Picture 2>, and so on in the prompt to refer to images in input order. Choose 1K, 2K, or 4K resolution and an aspect ratio; the default resolution is 2K. Alternatively, supply both width and height in pixels, with a total pixel count of 655360–20000000 and neither dimension exceeding 8192 pixels. Custom width and height cannot be combined with resolution or aspect_ratio. Submission returns an AE task ID; use ae_get_result with that ID to check progress and retrieve the generated image link when complete.
Pricing
| Condition | Charge |
|---|---|
| 1K / 2K output base price | 10.8 AE credits |
| 4K output base price | 33 AE credits |
| Each reference image, including the first | Add 3 AE credits |
Each successful job generates one image. The charge adds the output tier base price and a per-reference charge. The default tier is 2K. Custom dimensions up to 4.5 million pixels use the 1K/2K tier, and larger dimensions use the 4K tier.
The starting price applies to 1K or 2K output with one reference image. Looking up the same task does not charge again.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
seed | integer | No | 随机种子,省略时由供应商生成。 | — |
width | integer | No | 自定义宽度(像素),需和 height 一起传入。 | — |
height | integer | No | 自定义高度(像素),需和 width 一起传入。 | — |
prompt | string | Yes | 编辑指令,可在提示词中使用 <Picture 1> 等按顺序引用参考图。 | — |
image_urls | array | Yes | 按顺序提供 1–16 张公网可下载的参考图 URL,每张最多 20 MB 和 6400 万像素。 | — |
resolution | enum (1K | 2K | 4K) | No | 分辨率档位。使用自定义宽高时省略。 省略为 2K。按当前分辨率档位计费。 | — |
aspect_ratio | enum (auto | 1:1 | 5:4 | 4:5 | 4:3 | 3:4 | 3:2 | 2:3 | 16:9 | 9:16 | 21:9) | No | 输出宽高比。auto 跟随第一张参考图比例。传入自定义宽高时省略。 省略为 auto。 | — |
expand_prompt | boolean | No | 是否自动扩写提示词,默认开启。 | — |
output_format | enum (png | jpeg) | No | 输出格式。 省略为 png。 | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_minimax_h3_image_edit' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"prompt": "xxx",
"image_urls": [
"https://example.com/image.jpg"
]
}
}'No response example available yet.



