curl --request POST \
--url https://api.minimax.cn/v1/h3_image_context_ir \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-H3-Image",
"prompt": "一只橘猫趴在窗台上晒太阳，午后暖光，胶片质感"
}
'{
"created": 1794023743,
"revised_prompt": "一只橘色虎斑猫慵懒地趴在木质窗台上晒太阳，午后暖金色的阳光从窗外斜射进来，在猫毛和窗台上形成柔和的光斑，背景的窗帘与室内陈设略微虚化，整体呈现温暖的胶片质感，颗粒细腻、色调偏暖。",
"aspect_ratio": "3:2",
"usage": {
"total_tokens": 3489,
"input_tokens": 3489
},
"request_id": "021792308678142a2c883cf675b9804d"
}MiniMax-H3-Image
H3-Image-Context-IR
单独调用 MiniMax-H3-Image 的 Prompt 增强，同步返回增强后的 prompt，不生成图片。
POST
/
v1
/
h3_image_context_ir
curl --request POST \
--url https://api.minimax.cn/v1/h3_image_context_ir \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-H3-Image",
"prompt": "一只橘猫趴在窗台上晒太阳，午后暖光，胶片质感"
}
'{
"created": 1794023743,
"revised_prompt": "一只橘色虎斑猫慵懒地趴在木质窗台上晒太阳，午后暖金色的阳光从窗外斜射进来，在猫毛和窗台上形成柔和的光斑，背景的窗帘与室内陈设略微虚化，整体呈现温暖的胶片质感，颗粒细腻、色调偏暖。",
"aspect_ratio": "3:2",
"usage": {
"total_tokens": 3489,
"input_tokens": 3489
},
"request_id": "021792308678142a2c883cf675b9804d"
}本接口只返回增强后的 prompt，不会生成图片。
images 时按文生图增强，传入参考图时按图像编辑增强。可用于预览和修改增强结果，或在自己的工作流中分步调用。
当前支持模型：MiniMax-H3-Image；MiniMax-H3-Image-Highspeed 不支持本接口，传入返回 400。服务端最长等待 600 秒，建议客户端超时不低于 600 秒。
计费：Prompt 增强调用模型的输入、输出与思考 token 按单价折算为等价的输入文字 token，计入
usage.input_tokens，不单独计输出。请求失败（含未通过内容安全检查）不计费。分两步生成：文生图可将
revised_prompt 作为文生图请求的 prompt，设置 disable_prompt_enhanced: true，并传入响应中的 aspect_ratio（或自行指定 size / aspect_ratio），生成请求不再计 Prompt 增强的费用。图像编辑始终开启 Prompt 增强，将结果传给图像编辑接口时会再次增强并计费。授权
请求体
application/json
模型名称。可选值：MiniMax-H3-Image
可用选项:
MiniMax-H3-Image 需要增强的文本描述，最长 32000 个字符（按 Unicode 字符计，不含首尾空白），为空或只含空白时返回 400。
Maximum string length:
32000参考图列表，1 ~ 16 张。传入时结合参考图按图像编辑增强，不传时按文生图增强。
参考图限制（请求体总大小 ≤ 64 MiB，Base64 编码后的大小约为原文件的 4/3；超过该上限时请改用公网 URL 或 mm_file://）
| 项 | 限制 |
|---|---|
| 格式 | JPG、JPEG、PNG、WEBP、HEIC、HEIF |
| 单文件大小 | ≤ 64 MiB |
| 宽高范围 | [128, 8192] px |
| 长宽比（长边/短边） | ≤ 4:1 |
| 数量 | 1 ~ 16 |
Required array length:
1 - 16 elementsShow child attributes
Show child attributes
目标宽高比，默认 auto。只能在 size 不传或为 auto 时传入，size 为 宽x高 时传入返回 400。
auto：由 Prompt 增强决定，结果见响应中的aspect_ratioX:Y：X、Y 为 1 ~ 300 的整数，宽高比在 1:3 ~ 3:1 之间（含边界），如16:9、3:4。图像编辑增强按该比例描述画面，响应不返回aspect_ratio
示例:
"16:9"
面积档位，可选 1K、2K、4K，默认 4K。只能在 size 不传或为 auto 时传入，size 为 宽x高 时传入返回 400。不影响增强结果，便于与生成请求使用同一组参数。
可用选项:
1K, 2K, 4K 响应
增强成功，返回增强后的 prompt。
响应生成时间，Unix 时间戳（秒）。
增强后的 prompt。
Prompt 增强给出的宽高比，格式为 X:Y，在 1:3 ~ 3:1 之间。仅当比例由增强决定（size 不传或为 auto，且 aspect_ratio 不传或为 auto）时返回。
示例:
"3:2"
本次请求的 token 用量，用于计费。Prompt 增强的成本统一折算为输入文字 token，不单独计输出。
Show child attributes
Show child attributes
请求 ID（即 Trace ID），反馈问题时请提供。
此页面对您有帮助吗？