minimax-image

---

name: MiniMax Image Generation version: 1.0.0 category: file-generation author: MiniMax keywords: minimax, image generation, image-01, image-01-live, text to image argument-hint: "[text prompt or image URL]" description: > MiniMax AI图片生成，支持 image-01 和 image-01-live 模型。 image-01: 画面表现细腻，支持文生图、图生图 image-01-live: 手绘、卡通等画风增强，支持文生图并进行画风设置 需要 MiniMax API Key (Coding Plan)。

---

MiniMax Image Generation

使用 MiniMax Coding Plan API 调用 image-01、image-01-live 模型生成图片。

环境配置

API Key 获取: https://platform.minimaxi.com/user-center/basic-information/interface-key

export MINIMAX_API_KEY="your-api-key"

支持模型

| 模型 | 说明 | 支持比例 | |------|------|----------| | image-01 | 画面表现细腻，支持文生图、图生图 | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9 | | image-01-live | 手绘、卡通等画风增强 | 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16 |

支持比例

1:1 (1024x1024) - 默认

16:9 (1280x720)

4:3 (1152x864)

3:2 (1248x832)

2:3 (832x1248)

3:4 (864x1152)

9:16 (720x1280)

21:9 (1344x576) - 仅 image-01

使用方法

命令行

# 列出可用模型
python3 scripts/minimax_image_create.py --list-models
文生图 (image-01)
python3 scripts/minimax_image_create.py \
  --api-key $MINIMAX_API_KEY \
  --model image-01 \
  --prompt "一只可爱的橘猫" \
  --aspect-ratio 16:9
文生图 (image-01-live)
python3 scripts/minimax_image_create.py \
  --api-key $MINIMAX_API_KEY \
  --model image-01-live \
  --prompt "一只可爱的橘猫" \
  --style watercolor
图生图
python3 scripts/minimax_image_create.py \
  --api-key $MINIMAX_API_KEY \
  --model image-01 \
  --prompt "转换成水彩画风格" \
  --input-image https://example.com/image.jpg

参数说明

| 参数 | 说明 | 默认值 | |------|------|--------| | --api-key | MiniMax API Key | 环境变量 MINIMAX_API_KEY | | --model | 模型名称 (image-01/image-01-live) | image-01 | | --prompt | 图像描述 (必填) | - | | --aspect-ratio | 宽高比 | 1:1 | | --width | 自定义宽度 (仅 image-01) | - | | --height | 自定义高度 (仅 image-01) | - | | --n | 生成数量 [1-9] | 1 | | --seed | 随机种子 | 随机 | | --prompt-optimizer | 开启 prompt 自动优化 | false | | --aigc-watermark | 添加水印 | false | | --response-format | 返回格式 (url/base64) | url | | --input-image | 输入图片 (图生图) | - | | --style | 画风 (仅 image-01-live) | - | | --output-json | JSON 格式输出 | - |

image-01-live 画风选项

> ⚠️ 注意: style 参数当前可能不稳定，建议先用默认设置生成。

realistic - 写实

animation - 动画

comic - 漫画

watercolor - 水彩

oil_painting - 油画

sketch - 素描

cartoon - 卡通

hand_drawn - 手绘

API 参考

端点: POST https://api.minimaxi.com/v1/image_generation

请求头:

Authorization: Bearer 
Content-Type: application/json

请求体:

{
  "model": "image-01",
  "prompt": "图像描述",
  "aspect_ratio": "16:9",
  "n": 1,
  "response_format": "url",
  "prompt_optimizer": false
}

响应:

{
  "id": "task_id",
  "data": {
    "image_urls": ["https://..."]
  },
  "metadata": {
    "success_count": "1"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

注意事项

1. API Key: 需要在 https://platform.minimaxi.com 开通 Coding Plan 并获取 API Key 2. 生成数量: n 取值范围 [1, 9] 3. 图片尺寸: 自定义宽高时，范围 [512, 2048]，必须是 8 的倍数 4. URL 有效期: 返回的 URL 有效期为 24 小时 5. 图生图: 使用 --input-image 参数指定输入图片 URL