MiniMax H3 图片编辑
POST
/api/v1/jobs/createTask
<Picture 1>、<Picture 2>…（或"第一张图"）指代参考图。参考图
http(s):// 图片地址，每张 ≤ 20 MB、≤ 64 MP；支持 JPG / PNG / WEBP / HEIC / BMP（透明底会铺白）输出尺寸
resolution（默认 2K）决定尺寸档位，aspect_ratio 决定画幅。auto 跟随第一张参考图的比例（1:3 到 3:1 之间的任意比例），输出尺寸可能不在下表中。| 画幅 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
| 5:4 / 4:5 | 1152×912 / 912×1152 | 2304×1824 / 1824×2304 | 4576×3648 / 3648×4576 |
| 4:3 / 3:4 | 1184×880 / 880×1184 | 2368×1760 / 1760×2368 | 4736×3552 / 3552×4736 |
| 3:2 / 2:3 | 1248×832 / 832×1248 | 2496×1664 / 1664×2496 | 5024×3360 / 3360×5024 |
| 16:9 / 9:16 | 1360×768 / 768×1360 | 2720×1536 / 1536×2720 | 5472×3072 / 3072×5472 |
| 21:9 | 1568×672 | 3136×1344 | 6272×2688 |
width 与 height（像素，各 1–8192），如 width: 1920, height: 1080。总像素 655,360–20,000,000、宽 : 高在 1:3–3:1 之间，输出严格等于该宽高。使用宽高时不能再传 resolution 和 aspect_ratio，不支持这种组合。| 传了什么 | 输出尺寸与计费档位 |
|---|---|
width 和 height 都传（且不传 resolution、aspect_ratio） | 输出 width × height，按总像素计费（≤ 1.2 MP → 1K，≤ 4.5 MP → 2K，其余 → 4K） |
| 只传了其中一个 | 不允许：width 和 height 必须同时传 |
| 都没传 | 按 resolution（默认 2K）和 aspect_ratio（默认 auto） |
宽高与 resolution 或 aspect_ratio 同时传 | 不允许：请求会被拒绝 |
1K / 2K / 4K）一张一价，另按参考图张数加收（第一张也计）：width 和 height 都传时按其总像素归档，否则取 resolution；与 auto 选出的画幅无关。当前价格见 kie.ai/pricing查询任务状态
model=minimax-h3/image-edit 提交任务后，可通过统一的查询接口查看进度并获取结果：callBackUrl 参数接收生成完成的自动通知，而非轮询状态接口。相关资源
Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "minimax-h3/image-edit",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"prompt": "把 <Picture 1> 里的护肤品放到阳光照射的白色大理石浴室台面上，产品的形状、颜色和标签文字保持不变。",
"image_urls": [
"https://static.aiquickdraw.com/tools/example/1794319554733_LhkHjUSS.png"
],
"aspect_ratio": "auto",
"resolution": "2K",
"output_format": "png"
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_minimax_h3_1786417000000"
}
}