minimax-image

  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

```bash
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

## 使用方法

### 命令行

```bash
# 列出可用模型
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
```

**请求体**:
```json
{
  "model": "image-01",
  "prompt": "图像描述",
  "aspect_ratio": "16:9",
  "n": 1,
  "response_format": "url",
  "prompt_optimizer": false
}
```

**响应**:
```json
{
  "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