MiniMax H3 Image

​

模型

• minimax-h3-image — 不传 image_urls 时为文生图；传入 1 到 16 张参考图的 image_urls 时为图片编辑

​

功能

• 根据最多 5,000 个字符的提示词生成图像。
• 渲染图上文字，适合在提示词中用引号写出的标题、标签和说明文字。
• 支持图片编辑和多参考图合成，最多 16 张参考图，在提示词中用 <Picture 1>、<Picture 2> 等依次指代。
• 提供 10 种宽高比，可选 1K、2K 或 4K（21:9 最高 6272×2688），也支持 655,360 到 20,000,000 像素的自定义 WIDTHxHEIGHT 尺寸。
• 提示词扩写：把任意语言的简短提示词改写成对整幅画面的详细描述。
• 输出 PNG 或 JPEG。

​

输入模式

• 文生图 — 不传 image_urls。size 默认为 1:1，是否扩写提示词由 enable_prompt_expansion 控制。
• 图片编辑 — 在 image_urls 中传入 1 到 16 个 URL。第一个 URL 是 <Picture 1>，第二个是 <Picture 2>，依此类推；在提示词中用这些标记说明要修改哪张图、从哪些图中取用内容。size 默认为 auto，跟随 <Picture 1> 的宽高比。图片编辑请求始终会扩写提示词。

​

必填参数

• prompt (string)：描述图像或所需编辑的提示词，1–5,000 个字符，必须包含非空白文本。需要原样出现在图上的文字请用引号括起来，并写明放在哪里。

​

可选参数

• image_urls (array of strings)：1 到 16 个可公开访问的 HTTP(S) 参考图 URL（JPEG、PNG 或 WEBP，单张不超过 20 MB，每边 128 到 8192 像素）。传入后进入图片编辑模式。在提示词中按顺序指代这些图：第一个 URL 为 <Picture 1>，第二个为 <Picture 2>，依此类推。
• size (string)：1:1、5:4、4:5、4:3、3:4、3:2、2:3、16:9、9:16、21:9、auto 或自定义 WIDTHxHEIGHT。文生图默认为 1:1，图片编辑默认为 auto。auto 用于图片编辑。参见尺寸。
• resolution (string)：1K、2K 或 4K。默认为 2K。决定宽高比尺寸和 auto 的像素档位。自定义 WIDTHxHEIGHT 尺寸直接决定输出像素。
• enable_prompt_expansion (boolean)：生成前把提示词扩写成对整幅画面的详细描述。默认为 true。用于文生图请求。图片编辑请求始终会扩写提示词。
• output_format (string)：png 或 jpeg。默认为 png。

​

尺寸

• auto（图片编辑）：输出跟随 <Picture 1> 的宽高比，像素面积约等于所选档位（1024×1024、2048×2048 或 4096×4096）。宽和高都是 32 的倍数，宽高比保持在 1:3 到 3:1 之间。
• 自定义 WIDTHxHEIGHT：宽和高为整数，总像素数 655,360 到 20,000,000，宽高比在 1:3 到 3:1 之间（例如 2560x1440 或 1920x1080）。输出图像的宽高与请求完全一致。

​

示例

​

文生图

{
  "model": "minimax-h3-image",
  "input": {
    "prompt": "A vintage travel poster for Kyoto, headline text 'KYOTO' in large bold serif letters and subtitle 'City of a Thousand Gates' below, red torii gates receding up a mossy hill, autumn maple leaves, 1960s screen-print style",
    "size": "16:9",
    "resolution": "2K"
  }
}

​

多参考图编辑

{
  "model": "minimax-h3-image",
  "input": {
    "prompt": "Place the sofa from <Picture 2> and the floor lamp from <Picture 3> in the empty living room in <Picture 1>. Keep the walls, windows, and daylight of <Picture 1> unchanged.",
    "image_urls": [
      "https://example.com/empty-room.png",
      "https://example.com/sofa.png",
      "https://example.com/floor-lamp.png"
    ],
    "resolution": "2K"
  }
}

​

自定义尺寸

{
  "model": "minimax-h3-image",
  "input": {
    "prompt": "Minimal presentation background, soft gradient from deep navy to teal, subtle geometric lines in the lower right, large empty area on the left for text",
    "size": "1920x1080",
    "enable_prompt_expansion": false,
    "output_format": "jpeg"
  }
}

​

注意事项

• 每次请求生成一张图像。
• image_urls 必须是数组，即使只有一张图像。
• 参考图按在 image_urls 中的顺序编号。为获得更好的效果，请在提示词中说明每张图的作用，以及哪些地方要改、哪些保持不变。
• 一次请求通常在 10 到 25 秒左右完成。4K 输出和带多张参考图的编辑耗时更长。

Authorization: Bearer YOUR_API_KEY