方式一
通过 EvoLink API 接入
适合：产品后端、批量任务、自动化工作流
在你的服务端直接调用 EvoLink 统一图像 API，自己控制模型 ID、参数、任务队列、callback 和结果存储。
- 1在 Playground 用真实 brief 验证效果和成本
- 2在控制台创建 EvoLink API Key
- 3按上方路由卡选择与任务匹配的模型 ID
- 4提交任务，通过轮询或 HTTPS callback 获取结果
MiniMax H3 Image API
通过 EvoLink 调用 MiniMax H3 Image API，支持文生图和最多 16 张参考图编辑。先测试 1K、2K、4K 输出、估算 token 费用，再用同一个 API Key 接入应用。
MiniMax图像生成可用
$0.0038 / 1K 图像输出 token 起
文生图图像编辑多参考图输入自定义像素尺寸提示词优化批量生成
生产路由已上线
模型特点
输出最高 2000 万像素，尺寸设置灵活，内置提示词优化
适用场景
高分辨率营销图、多参考图编辑、批量出变体
输入
文字提示词，可选最多 16 张参考图
输出
每次请求最多 10 张，JPEG、PNG 或 WebP 格式
接入 API 之前，先试试 MiniMax H3 Image
正式接入前，先测试 MiniMax H3 Image 的出图质量，估算一次请求的 token 费用，并生成一张样图。
创建图像任务
固定使用 minimax-h3-image支持图像生成与编辑，最终按实际 token 用量计费。
参考图
参考图会增加本次请求的输入 token 用量。
0/16 个文件
尺寸
由模型根据提示词和参考图决定画面比例，像素面积由分辨率决定。
分辨率
目标像素面积：1K 约 105 万像素，2K 约 419 万像素，4K 约 1678 万像素。1K 与 2K 的图像输出费用相同，4K 的输出 token 约为它们的 4 倍。
预估费用 ~$0.0261.7503 积分
auto @ 2K · 提示词优化: 开 · 参考图: 0 · 数量: 1
最终费用按实际 token 用量结算。
就绪
生成的图片会显示在这里。
历史记录
生成结果保留 24 小时，需要的请及时下载。
生成任务会显示在这里。
MiniMax H3 Image API 价格与单张生成成本
比较文生图、参考图编辑和 4K 请求的费用估算。图像输出、参考图输入和文字输入分别按 token 计费，最终按实际用量结算。
首次测试成本
MiniMax H3 Image - 2K - 1:1 - 1 张 - 关闭提示词优化积分~1.0855
生成 1 张，关闭提示词优化，不带参考图
预估成本~$0.016
$10 余额约可测试 598 次。
想在 Playground 里得到这个估算：尺寸选比例 1:1，分辨率选 2K，关闭提示词优化，不传参考图，用提示词“Cat”生成 1 张。提示词更长、开启提示词优化或加参考图都会增加输入费用；最终按实际用量结算。
MiniMax H3 Image 测试预算参考
按你预计的测试次数选择充值金额。$10
约 598 次测试
适合首次验证。
$50
约 3132 次测试
适合多轮提示词迭代。
$100
约 6264 次测试
适合生产接入前测试。
MiniMax H3 Image 常见成本示例
文生图，开启提示词优化2K - 1 张 - 提示词优化开
~$0.026/张
~1.7109 cr/张文生图，关闭提示词优化2K - 1 张 - 提示词优化关
~$0.016/张
~1.0853 cr/张4K 文生图4K - 1 张 - 提示词优化开
~$0.074/张
~4.9668 cr/张带参考图编辑2K - 1 张 - 1 张参考图
~$0.041/张
~2.7615 cr/张每个估算按当前单价、生成 1 张计算，不含你自己提示词文本的 token。最终按实际 token 用量结算。
MiniMax H3 Image 模型定价
费率单位为每 1K tokens。计算器估算整次请求的费用，最终按实际用量结算。
MiniMax H3 Image按 token 计费
minimax-h3-image没有固定的单张价格：费用取决于输出尺寸、提示词优化、参考图和生成张数。
| 计费项目 | 计费范围 | 单价 |
|---|---|---|
| 图像输出 | 每张生成图的 token：1K 或 2K 约 4,200，4K 约 16,800。超过 2K 的自定义像素尺寸按宽 × 高 ÷ 1,024 计算。 | $0.0038/1K tokens0.2584 cr/1K tokens |
| 图像输入 | 编辑时的参考图：每张参考图约 10,300 tokens，每生成一张图各计一次。 | $0.0015/1K tokens0.102 cr/1K tokens |
| 文字输入 | 你的提示词；开启提示词优化时，每生成一张图另加约 4,000 tokens。 | $0.0023/1K tokens0.1564 cr/1K tokens |
图像输出
每张生成图的 token：1K 或 2K 约 4,200，4K 约 16,800。超过 2K 的自定义像素尺寸按宽 × 高 ÷ 1,024 计算。
$0.0038/1K tokens0.2584 cr/1K tokens
图像输入
编辑时的参考图：每张参考图约 10,300 tokens，每生成一张图各计一次。
$0.0015/1K tokens0.102 cr/1K tokens
文字输入
你的提示词；开启提示词优化时，每生成一张图另加约 4,000 tokens。
$0.0023/1K tokens0.1564 cr/1K tokens
EVOLINK · 费用估算minimax-h3-image
× 1 · 实时这是提交时预先冻结的估算金额，最终按实际 token 用量结算。
预计费用
~$0.0261.7109 cr
每 $10
≈ 379 张图片
自动 · 2K · 提示词优化: 开
Token 用量（单张 × 张数）
图像输出4,200 × 1 = 4,200
图像输入0 × 1 = 0
文字输入4,000 × 1 = 4,000
尺寸
由模型根据提示词和参考图决定画面比例；输出面积仍由分辨率决定。
分辨率
生成张数
1
参考图
0
提示词优化
size 为 auto 或请求带参考图时，提示词优化始终开启。
提示词
0 / 32,000 字符
计费说明
- 1K 和 2K 的图像输出 token 数相同，因此图像输出费用相同。整次请求的费用还包含文字与参考图输入。
- 4K 的图像输出 token 约为 2K 的 4 倍。
- 文字输入和参考图输入按每张生成图各收一次，所以整笔估算随生成张数（n）等比增加。
- 页面显示的金额是提交时预先冻结的估算；最终按任务实际用量结算，多退少补。
- 任务失败全额退还。只有部分图片生成成功时，只按实际交付的图片计费。
MiniMax H3 Image API 支持哪些能力？
MiniMax H3 Image 是 MiniMax 的图像生成与编辑模型。EvoLink 通过统一 API 路由提供调用，可用于商品场景图、营销素材和概念探索，支持最多 16 张参考图，单张最高约 2000 万像素。用于生产前，请按自己的需求审核结果。
一个模型 ID minimax-h3-image 覆盖两种模式：只传提示词就是文生图，加上 image_urls 就是参考图编辑。请求以异步任务运行，按 token 计费。
模式: 文生图与图像编辑 · 计费: 按 token：图像输出、参考图输入、文字输入 · 交付: 异步任务；结果链接 24 小时内有效
输入
文字提示词 + 最多 16 张参考图
输出
1–10 张 · JPEG / PNG / WebP
尺寸
自动 / 比例 / 自定义像素，最高 2000 万像素
分辨率
1K / 2K / 4K（默认 2K）
模型 ID
minimax-h3-image
MiniMax H3 Image 的模型 ID 与模式
MiniMax H3 Image
minimax-h3-image文生图和图像编辑共用一个模型 ID，都走 POST /v1/images/generations。只传提示词是生成，在 image_urls 里加 1–16 张参考图就是编辑。接口返回的是任务 ID，不是成品图。
MiniMax H3 Image 的能力与控制项
MiniMax H3 Image 文生图
提示词最长 32,000 个字符，一次返回 1–10 张图。size 保持 auto 时，由模型根据提示词决定画面比例。
MiniMax H3 Image 参考图编辑
在 image_urls 里放 1–16 个图片 URL，再用提示词描述要怎么改，提示词里用“image 1”“image 2”指代各张图。编辑用的是同一个模型 ID，每张参考图都会增加图像输入 token。
MiniMax H3 Image 尺寸：自动、比例或自定义像素
auto 由模型决定画面比例。比例 X:Y 的两项取 1 到 300 的整数，且须在 1:3 到 3:1 之间。自定义像素 WxH 的总像素须在 655,360 到 20,000,000 之间，按原样出图，不缩放、不取整。
MiniMax H3 Image 分辨率档位：1K、2K 与 4K
resolution 决定 auto 和比例尺寸下的输出面积，默认 2K；自定义像素时不生效。1K 和 2K 的图像输出 token 费用相同，4K 的输出 token 约为它们的四倍。总费用还包含文字与参考图输入。
MiniMax H3 Image 提示词优化
默认开启：模型会把你的提示词改写得更详细，并随每张图返回实际使用的提示词。只有文生图且尺寸为比例或自定义像素时才能关闭；尺寸为 auto 或带参考图时始终开启。
MiniMax H3 Image 用 n 批量生成
把 n 设为 1 到 10，一次请求就能拿到多张图。文字输入和参考图输入按每张生成图各收一次，所以费用随 n 增加。
MiniMax H3 Image 主要请求参数
这些字段决定 POST /v1/images/generations 的输出与费用。生成是异步的：轮询返回的任务 ID，或使用回调；图片链接只在 24 小时内有效，请及时保存结果。完整 schema 和代码示例见 API 标签页。
| 参数 | 类型 | 作用 |
|---|---|---|
| model | string · 必填 | 固定为 'minimax-h3-image'。文生图和图像编辑用同一个 ID。 |
| prompt | string · 必填 | 要生成什么，或者怎么编辑参考图。最长 32,000 个字符；prompt_extend 关闭时，只有前约 4,096 个 token 生效。 |
| size | string · 默认 auto | 'auto'、比例 X:Y（1–300 的整数，在 1:3 到 3:1 之间），或自定义像素 WxH（总像素 655,360–20,000,000）。超出范围返回 400，不会缩放或取整。 |
| resolution | string · 1K / 2K / 4K | auto 和比例尺寸下的输出面积，默认 2K。自定义像素时不生效。1K 和 2K 的图像输出 token 数相同，4K 约为四倍。 |
| prompt_extend | boolean · 默认 true | 提示词优化。只有文生图且尺寸为比例或自定义像素时才接受 false；size 为 auto 或带 image_urls 时传 false 会返回 400。 |
| n | integer · 1–10 | 每次请求生成的张数，默认 1。文字输入和参考图输入按每张生成图各收一次。 |
| image_urls | array · 最多 16 张 | 编辑用的参考图：支持 jpg、jpeg、png、webp、heic、heif；每边 128–8192 px；长边不超过短边的 4 倍；单张不超过 64 MB。每张都会增加图像输入 token。 |
| output_format | string · jpeg / png / webp | 结果的文件格式，默认 jpeg。不支持透明背景。 |
| callback_url | string · 可选 | 接收任务结果的 HTTPS webhook，可替代轮询。 |
两种方式接入 MiniMax H3 Image：EvoLink API 或 Agent
需要嵌入产品、运行批量任务时，直接使用 EvoLink API；需要快速创作、试验或让 Agent 完成接入时，可在 Codex、Claude 或 Gemini 中调用。两种方式共用 EvoLink API Key、余额、模型路由和任务记录。
方式二
在 Agent 中调用
适合：Codex、Claude、Gemini 中的创作与开发任务
把输出目标、素材和验收标准交给 Agent，它可以选择路由、组装请求、跟踪任务并返回结果，不需要你手写每一步。
- 1在本地环境变量中设置 EVOLINK_API_KEY，不要写进代码或 Prompt
- 2描述输出目标、参考素材和关键参数
- 3让 Agent 调用 MiniMax H3 Image 路由并保存 task ID
- 4让 Agent 轮询到最终状态、下载结果并报告失败原因
你可以用 MiniMax H3 Image 做什么
商品场景图与营销素材
用 4K 档生成活动主视觉、横幅和商品场景图；投放位要求特定尺寸时，可以直接指定像素，最高约 2000 万像素。
结合商品、场景与风格参考图编辑
一次请求最多可以组合 16 张参考图，比如一张商品图、一张背景图和一张风格样图，再在提示词里用 image 1、image 2 等称呼它们，告诉模型每张图怎么用。
批量生成候选图供审核
用 n 让同一条提示词一次最多出 10 张图，再挑出值得继续打磨的。如果部分图片被拦截，任务仍会返回其余图片，并且只对这些图片计费。
适配固定像素版位
输出必须贴合固定版位时，直接传 WxH，比如幻灯片背景用 1920x1080。只要尺寸在允许范围内，就按请求原样生成，不缩放、不取整。
为多个投放位准备素材
同一条提示词可以套用 1:1、4:5、16:9、9:16 等比例，覆盖信息流、故事和横幅等投放位；也可以使用 1:3 到 3:1 之间的任意整数比例。
将简短需求扩写为创作描述
从一句话的想法开始，让提示词优化把它扩写开来。实际使用的提示词会随每张图返回，方便你查看、修改和复用。
MiniMax H3 Image API 代码示例与错误处理
示例展示最短可运行流程：创建任务、保存返回的 task ID，然后轮询或等待 HTTPS callback。完整参数与响应字段见 API 标签页。
cURL
curl -X POST https://api.evolink.ai/v1/images/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "A colorful sunset over the ocean, painterly style",
"size": "16:9",
"resolution": "2K",
"n": 1,
"callback_url": "https://your-domain.com/webhooks/image-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"这个请求不能关闭提示词优化
size 为 auto 或带 image_urls 时，prompt_extend: false 会返回 400。文生图请改用比例或自定义像素，或者保持提示词优化开启。请求会在扣费前被拒绝。
尺寸超出范围
自定义像素的总像素须在 655,360 到 20,000,000 之间；所有尺寸的比例都须在 1:3 到 3:1 之间，比例两项取 1 到 300。超出范围的尺寸返回 400，不会替你缩放或取整。
参考图过多或不受支持
image_urls 里超过 16 个 URL 会返回 400。每张图还必须是 jpg、jpeg、png、webp、heic 或 heif 格式，每边 128 到 8192 px，长边与短边之比不超过 4:1，且不超过 64 MB。
参数校验失败
对照上方参数卡逐项检查：取值范围、可选枚举、素材数量和文件类型必须与所选路由一致。
鉴权或余额问题
检查 Authorization Bearer Token，并在控制台确认可用余额与任务计费。
内容或素材被拒
检查肖像权、品牌素材、可读文字、敏感内容以及输入素材的合规性。
任务失败或超时
MiniMax H3 Image 任务最终状态为失败时不扣费。保留 task ID，查看最终状态，先判断是校验、审核还是执行环节出错，再决定是否重试。
未收到 callback
callback_url 必须是公网 HTTPS 地址，不能是 localhost 或内网地址。始终保留 task ID 作为轮询兜底。
MiniMax H3 Image 与 EvoLink 上其他图像模型对比
| 对比项 | MiniMax H3 Image | GPT Image 2.6 Flare | Nano Banana 2.1 | Seedream 5.0 Pro | Grok Imagine Image 2.0 |
|---|---|---|---|---|---|
| 计费方式 | 按 token：图像输出、图像输入、文字输入 | 按 token | 按张、按分辨率计费；参考图和搜索单独计费 | 按张、按输出档位计费；每张输入图都计费 | 按张、按画质和分辨率计费 |
| 输出分辨率 | 1K / 2K / 4K，或自定义像素，最高 2000 万像素 | 1K / 2K / 4K | 1K / 2K / 4K | 1K / 1.5K / 2K | 1K / 2K |
| 尺寸选项 | auto、1:3 到 3:1 之间的任意比例，或自定义像素 | auto、15 种比例，或自定义像素 | auto 或 14 种比例 | auto、比例，或自定义像素 | auto 或 13 种预设比例 |
| 参考图 | 最多 16 张 | 最多 16 张 | 最多 14 张 | 最多 10 张 | 最多 3 张 |
计费方式
MiniMax H3 Image按 token：图像输出、图像输入、文字输入
GPT Image 2.6 Flare按 token
Nano Banana 2.1按张、按分辨率计费；参考图和搜索单独计费
Seedream 5.0 Pro按张、按输出档位计费；每张输入图都计费
Grok Imagine Image 2.0按张、按画质和分辨率计费
输出分辨率
MiniMax H3 Image1K / 2K / 4K，或自定义像素，最高 2000 万像素
GPT Image 2.6 Flare1K / 2K / 4K
Nano Banana 2.11K / 2K / 4K
Seedream 5.0 Pro1K / 1.5K / 2K
Grok Imagine Image 2.01K / 2K
尺寸选项
MiniMax H3 Imageauto、1:3 到 3:1 之间的任意比例，或自定义像素
GPT Image 2.6 Flareauto、15 种比例，或自定义像素
Nano Banana 2.1auto 或 14 种比例
Seedream 5.0 Proauto、比例，或自定义像素
Grok Imagine Image 2.0auto 或 13 种预设比例
参考图
MiniMax H3 Image最多 16 张
GPT Image 2.6 Flare最多 16 张
Nano Banana 2.1最多 14 张
Seedream 5.0 Pro最多 10 张
Grok Imagine Image 2.0最多 3 张
MiniMax H3 Image 接入要点
一个端点，一个模型 ID
向 POST /v1/images/generations 发请求，model 填 minimax-h3-image。文生图和编辑走同一条路由，加上 image_urls，请求就变成编辑。
异步任务的生命周期
创建请求会返回任务 ID。轮询 GET /v1/tasks/{task_id}，直到任务完成或失败；也可以传一个 HTTPS 的 callback_url。结果链接 24 小时内有效，需要的文件请及时保存。
按 token 计费
共有三个费率：图像输出、参考图输入，以及文字输入（包含你的提示词和提示词优化）。任务开始时先冻结一笔估算金额，最终按实际用量结算。任务失败全额退还。
为什么通过 EvoLink 使用 MiniMax H3 Image
生成前先估算费用
Playground 和价格计算器会根据尺寸、分辨率、提示词优化开关、参考图和 n 估算一次请求的费用。任务开始时先冻结这笔估算金额，最终按模型返回的实际用量结算。
实际用量低于或高于估算时，差额多退少补，所以每条任务记录显示的都是这次请求的真实用量。
生成和编辑共用一个模型 ID
minimax-h3-image 在同一个端点上同时支持文生图和参考图编辑。从纯文字的原型升级到编辑流程，只需在请求里加上 image_urls，不用再接入第二条路由或第二个模型 ID。
一个 API Key 通用图像、视频、音频和 LLM 模型
调用 minimax-h3-image 的这个 API Key，同样可以调用 MiniMax 的视频模型、Nano Banana 2.1 和 Seedream 5.0 Pro 等其他图像模型，以及 EvoLink 上的文本模型，共用一份余额和一份任务历史。
对图像工作来说，整条流程可以留在一处：在这里生成一张静态图，拿它作为视频模型的首帧，或者用同一份需求试试别的图像模型，都不用另开账号。
可核查的任务状态
每个任务都会报告等待中、处理中、已完成或失败，任务失败全额退还。只有部分图片生成成功时，任务会带着这些图片完成，并且只对它们计费。
轮询任务或使用回调，确认最终状态，并保留任务 ID，这样每笔扣费都能对应到具体请求。
MiniMax 模型家族
EvoLink 上的 MiniMax 视频模型，与 MiniMax H3 Image 共用同一个账户和 API Key。
MiniMax H3 Image 之外，EvoLink 上的其他图像模型
MiniMax H3 Image API 常见问题
MiniMax H3 Image API 的模型 ID 是什么？
模型 ID 是 minimax-h3-image，全小写、用连字符连接。文生图和图像编辑都在 POST /v1/images/generations 里把它作为 model 传入。它和 minimax-h3-image-to-video 不是同一个模型，后者是 MiniMax H3 的视频路由。
MiniMax H3 Image 怎么计费？
按 token 计费，共三个费率：图像输出、参考图输入，以及文字输入（包含你的提示词和提示词优化）。任务开始时先冻结一笔估算金额，最终按模型返回的实际用量结算，差额多退少补。文字输入和参考图输入按每张生成图各计一次，所以费用随 n 增加。当前费率见本页价格区。
为什么 MiniMax H3 Image 的 1K 和 2K 图像输出费用相同？
两个档位每张图使用的图像输出 token 数相同，因此图像输出费用相同。总费用还包含提示词处理和参考图输入。4K 的图像输出 token 约为它们的四倍。超过 2K 面积的自定义像素尺寸，输出 token 按宽 × 高 ÷ 1024 计算。
什么时候可以关闭提示词优化？
prompt_extend 默认开启。只有文生图且尺寸为比例或自定义像素时，才能把它设为 false。size 为 auto 或请求带 image_urls 时，传 false 会被拒绝并返回 400 错误，不会产生任何扣费，因为自动比例和编辑都依赖优化这一步。关闭后，提示词只有前约 4,096 个 token 生效。
最大能出多大的图？可以自定义像素吗？
输出最高可达 20,000,000 像素，即约 2000 万像素（20 MP）。要自定义像素，把 size 写成 WxH，总像素在 655,360 到 20,000,000 之间，画面比例在 1:3 到 3:1 之间；不要求是 16 的倍数，尺寸也不会被缩放或取整。使用 auto 或比例时，由 resolution 选择 1K、2K 或 4K：例如 16:9 在 2K 下是 2720×1536，在 4K 下是 5472×3072。
最多能传多少张参考图？有哪些限制？
每次请求最多在 image_urls 里传 16 张。支持 jpg、jpeg、png、webp、heic 和 heif 格式；每边须在 128 到 8192 px 之间，长边不超过短边的 4 倍，单个文件不超过 64 MB。在提示词里用 image 1、image 2 等指代它们。怎么改全靠提示词描述：不支持蒙版局部重绘，也不支持透明背景。
一次请求里有部分图片失败会怎样？
任务仍会带着成功的图片完成，例如多张图里有一张被内容安全检查拦截时，只对成功的图片计费。因此返回的结果数可能少于 n。如果整个任务失败，全额退还。
怎么获取结果？链接能用多久？
生成是异步的。创建请求会返回任务 ID；轮询 GET /v1/tasks/{task_id}，直到状态变为 completed，或者设置 callback_url，在 HTTPS 端点上接收结果。结果链接 24 小时内有效，想保留的图片请及时下载并保存。
MiniMax H3 Image 的 4K 输出一定是 4096 像素宽吗？
4K 是输出面积档位，目标为 4096 × 4096 像素，并非固定宽度。实际尺寸取决于宽高比：文档中的 16:9 示例为 5472 × 3072。EvoLink 在自动或比例尺寸下默认使用 2K；指定自定义像素时，以明确的宽高为准。
MiniMax H3 Image API 和 H3 图生视频是一回事吗？
不是。minimax-h3-image 路由生成静态图片，并支持参考图编辑；minimax-h3-image-to-video 路由生成视频，输入要求和计费规则独立。MiniMax 直连 API 的模型名称和默认值也可能不同，请使用本页说明的 EvoLink 模型 ID 与请求选项。