Claude Opus 5.5 已在 SeedRouter 上线
LogoSeedRouter

Image

MiniMax H3 Image Highspeed

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-highspeed","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-highspeed
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 也不例外。

省略 size 或将其设为 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-highspeed",
  "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-highspeed","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-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

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

错误

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

相关页面

Midjourney

Previous Page

MiniMax H3 Image

Next Page

On this page

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