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 <API_KEY>
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"
}
}
注意事项
- API Key: 需要在 https://platform.minimaxi.com 开通 Coding Plan 并获取 API Key
- 生成数量: n 取值范围 [1, 9]
- 图片尺寸: 自定义宽高时，范围 [512, 2048]，必须是 8 的倍数
- URL 有效期: 返回的 URL 有效期为 24 小时
- 图生图: 使用
--input-image参数指定输入图片 URL