Claude Opus 5.5 已在 SeedRouter 上线
LogoSeedRouter

Image

MiniMax H3 Image

View Markdown

生成和编辑图像，支持最多 16 张参考图、精确尺寸、1–10 张输出，并按 token 计费。

快速示例

提交一个图像请求，保存返回的 id，并轮询直到任务状态为 completed 或 failed。此 API 使用异步任务，并通过 URL 返回输出。

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

端点与请求头

POST https://api.seedrouter.ai/v1/images/generations

请求头值
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

将密钥保存在服务器端。HTTP 成功响应表示任务已被接收，并不意味着图像已准备就绪。

参数

共接受 13 个字段。只有 model 和 prompt 为必填项。省略可选字段即可使用默认值；所有字段均不接受 null。Playground 提供固定模型和十个可编辑输入项。响应格式固定为 URL，任务交付固定为非流式。

字段类型默认值约束
model字符串必填minimax-h3-image
prompt字符串必填去除首尾空白后为 1–32,000 个 Unicode 字符
images对象数组省略1–16 个有序对象，每个对象均包含 image_url
disable_prompt_enhanced布尔值false仅适用于生成；参见下方依赖关系
n整数11–10
size字符串autoauto 或 WIDTHxHEIGHT；使用小写 x
aspect_ratio字符串autoauto 或 X:Y；X 和 Y 为 1–300 的整数；比例为 1:3–3:1
area字符串4K1K, 2K, 4K; 近似目标面积为 1,024²、2,048²、4,096² 像素
output_format字符串jpegjpeg, jpg 别名, png
output_compression整数950–100；JPEG 质量；对 PNG 忽略此项
aigc_watermark布尔值false添加 AI 生成内容水印
response_format字符串url仅限 url
stream布尔值false仅限 false；使用任务 ID 轮询

尺寸与提示词的依赖关系

显式指定的 size 必须包含正整数尺寸，面积须在 655,360 至 20,000,000 像素之间，包含边界值。宽度除以高度须在 1/3 至 3 之间。例如，2048x1152 是有效值。使用明确尺寸时，必须同时省略 aspect_ratio 和 area，即使它们的值为 auto 也不例外。

省略尺寸或将尺寸设为 auto 时，应搭配使用 aspect_ratio 和 area。面积是目标尺寸；请检查交付文件以确认精确尺寸。它并不代表固定的单张图像价格。

设置 disable_prompt_enhanced: true 时，必须提供明确的像素尺寸或固定宽高比。关闭增强后，模型读取提示词中大约前 4,096 个 token。32,000 个字符的提交上限仍然适用。编辑始终会增强提示词，因此存在 images 时不接受 true。

不接受遮罩、种子、风格、质量、负面提示词、背景或独立的分辨率字段。未知参数会在提交前返回错误。此 API 不提供流式输出、base64 图像或 WebP 输出。

参考图

使用可公开访问且不含嵌入式凭据的 HTTP(S) URL。每张图像必须为 JPEG、PNG、WebP、HEIC 或 HEIF 格式；大小不超过 64 MiB；每条边为 128–8,192 像素；长边与短边之比不超过 4。JSON 请求体须不超过 64 MiB。图像文件通过 URL 引用，其字节内容不嵌入 JSON 请求体。

为每张参考图指定明确用途，并说明哪些内容应保持不变。数组顺序对应 <Picture 1>、<Picture 2>，依此类推。

{
  "model": "minimax-h3-image",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

将示例 URL 替换为你自己的可访问图像文件。

计费

计费包含三类 token：文本输入、图像输入和图像输出。各类别的实际用量乘以其实时费率。输出数量、图像尺寸和参考图会影响用量；分辨率名称并不决定固定账单金额。失败的请求不收费。参见实时价格。

任务响应与轮询

被接收的请求会返回一个异步任务：

{"id":"task_example","model":"minimax-h3-image","status":"processing"}
curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

已完成的响应在 output.data 中包含图像 URL。每张交付图像都包含其 size，并且可能包含 revised_prompt（增强后的描述）。output.created 是以 Unix 秒表示的创建时间，output.output_format 表示交付格式。output.usage 提供文本输入、图像输入和图像输出的 token 数，以及已交付的 generated_images 数量。以下 URL 和 ID 仅为示例：

{
  "id": "task_example",
  "model": "minimax-h3-image",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

每隔 10–20 秒轮询一次。客户端超时并不意味着任务失败：保留任务 ID 并继续轮询，不要提交重复请求。公开响应不包含账户余额或费用。

错误

HTTP 错误使用 {"error":{"code":integer,"message":string}} 格式。失败的任务包含 status: "failed" 和错误信息。重新提交前，请修正无效参数。参见通用错误目录和任务生命周期。

相关页面

MiniMax H3 Image Highspeed

Previous Page

Muse Image

Next Page

On this page

快速示例端点与请求头参数尺寸与提示词的依赖关系参考图计费任务响应与轮询错误相关页面