MiniMax H3 Image 接入说明
minimax-h3-image 的平台接口, 参数范围和计费方式
ToAPIs 模型标识为 minimax-h3-image. 文生图与参考图编辑使用同一模型标识, 均提交异步图片任务.
可用性和价格以当前站点及账户的控制台展示为准. 文档中的接口说明不代表所有账户或区域均已开放.
使用入口
| 用途 | 平台接口 | 文档 |
|---|---|---|
| 文生图 | POST /v1/images/generations | 图像生成 |
| URL 参考图编辑 | POST /v1/images/generations (传 image_urls) | 图像生成 |
| 结果查询 | GET /v1/images/generations/{task_id} | 图片任务状态 |
| 完成通知 | 创建任务时设置 webhook | 任务 Webhook |
接口地址使用 https://toapis.com, 中国大陆用户使用 https://toapis.cn. 提交后保存任务 id, 通过查询或 Webhook 获取结果, 不要将提交成功理解为图片已完成.
参数摘要
prompt去除首尾空白后为 1-32000 个 Unicode 字符;n为 1-10, 默认 1.- 自动尺寸支持
resolution=1K/2K/4K, 默认4K, 可搭配aspect_ratio. - 显式像素
size要求总像素 655360-20000000, 宽高比 1:3 到 3:1, 不可同时传resolution或aspect_ratio. - 参考图使用
image_urls, 最多 16 个 HTTP(S) URL. 编辑时至少提供 1 张参考图, 并保持提示词增强开启. - 输出支持 JPEG, PNG 和 WebP, 默认 JPEG;
response_format仅支持url. - 不支持 Base64 输入或输出, multipart 文件上传, 流式输出和蒙版编辑. 完整字段限制见图像生成.
对外计费
费用按实际文本输入 tokens, 图片输入 tokens 和图片输出 tokens 分别计算, 不是固定每张价. 三项费率的单位均为每百万对应类型的 tokens.
三项费率均通过所在站点及账户的控制台报价查询, 本页不提供固定售价. 不要跨区域或账户推算价格; 未显示有效报价时, 不应按免费使用或其他模型价格估算.
最终消费读取任务返回的 billing.cost_usd 或 billing.credits, 并确认 billing.status=settled. 预扣不是最终费用, n 也不是最终收费张数. 详见价格与实际费用.
接入记录
本页记录 minimax-h3-image 的平台使用范围: JSON 文生图, URL 参考图编辑, 异步结果查询和分项 token 计费. 部分成功时只在 result.data 返回成功图片, 失败项见 result.failed_images.
本模型没有单独的定价文档或历史记录目录, 因此由本页归档能力摘要, 图像系列目录提供接口入口, 售价统一通过控制台报价查询. 本记录不代表区域或账户开通通知.
公开模型目录按页面标注日期的公开价格目录整理. 本页提供接口说明, 不据此将模型加入该目录的已开放列表或调整其模型数量; 实际可用性仍需在所在站点及账户确认.