跳转到主要内容
minimax/minimax-h3-image 的 API 参考,由 Comfy Router 提供,模型来自 MiniMax。 输入: 文本、图像 · 输出: 图像

快速开始

在你的 Comfy 工作区中创建密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk 和 npm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 模型 ID: minimax/minimax-h3-image 端点: POST https://api.comfy.org/v2/models/minimax/minimax-h3-image
相同的请求体,发送到 POST https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests。一旦运行被接纳,Router 就会返回 201 和一个 request_id,结果在就绪后即可收集,可由本进程或另一个进程完成。队列交付详细介绍了状态、取消与收集。

Schema

输入

string
当省略 size 或为 auto 时,输出面积级别。取值为 1K、2K、4K(默认)。
string
当省略 size 或为 auto 时,输出宽高比。auto(默认),或 1:3 到 3:1 之间的 X:Y,例如 16:9。
boolean
默认值:"false"
关闭 MiniMax 的提示词增强。需要搭配固定的 size 或 X:Y 形式的 aspect_ratio。
object[]
可选的参考图像。存在时,请求将以图像编辑方式执行,与编辑路由完全一致。
string
必填
公开的 http(s) URL,或 data:image/<format>;base64, URI。支持 JPEG、PNG、WEBP、HEIC 或 HEIF,每边 128 至 8192 px,长边不超过短边的 4 倍。
string
模型名。MiniMax-H3-Image 或 MiniMax-H3-Image-Highspeed。Router 调用方可以省略此字段或发送 null;Router 会填入由请求路径所选的模型。
integer
默认值:"1"
图像数量。输入 token 按每张图像计费一次。范围:1 到 10
integer
jpeg 和 webp 的压缩质量,默认 95。范围:0 到 100
string
输出图像格式。取值为 png、jpeg、jpg(默认)、webp。
string
必填
图像的文字描述。与 images 一起使用时,为编辑的描述;参考图像按数组顺序依次为图像 1、图像 2,以此类推。
string
输出尺寸,auto(默认)或 WIDTHxHEIGHT,例如 2720x1536。固定尺寸的面积必须为 655,360 至 20,000,000 像素,宽高比在 1:3 到 3:1 之间,且不能与 aspect_ratio 或 area 同时使用。
由 Router 在 GET /v2/models/minimax/minimax-h3-image/openapi.json 提供的 schema 生成,这也是请求到达提供商之前校验调用所用的同一份文档。

输出

integer
格式:int64
object[]
object
仅当该图像失败或被拦截时存在。
string
string
string
MiniMax 为该图像使用的提示词。
string
实际图像尺寸,格式为 WIDTHxHEIGHT。
string
生成图像的 URL。该 URL 会过期,请下载图像。
string
string
object
成功图像的 token 用量。计费以此为基础。
integer
integer
object
integer
integer
integer
object
integer
integer

示例

输入

输出

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入,413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载,因为结果 URL 会过期。 上文任何字段描述中提到的尺寸限制,都是提供商对该字段自身的限定,引自提供商的规范。Router 会对整个请求体另行设置上限,base64 编码的媒体内容也计入其中:参见请求体大小。 本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 comfy-sdk / @comfyorg/sdk 包还提供第二个客户端,用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图:Comfy(api_key=...) / new Comfy({ apiKey }),并带有 client.workflows、client.assets 和 client.jobs。请参阅 Comfy SDKs。

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、验证错误、重试与计费。

限制

Router 目前不支持的功能,以及替代方案。