# MiniMax 文生图 API 参考

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

## 请求头
```
Authorization: Bearer <API_KEY>
Content-Type: application/json
```

## 请求体参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `model` | string | ✅ | `image-01` 或 `image-01-live` |
| `prompt` | string | ✅ | 图像描述，最长 1500 字符 |
| `aspect_ratio` | string | ❌ | `1:1` `16:9` `4:3` `3:2` `2:3` `3:4` `9:16` `21:9` 默认 `1:1` |
| `response_format` | string | ❌ | `url` 或 `base64`，默认 `url`（24小时有效） |
| `n` | integer | ❌ | 生成数量 1-9，默认 1 |
| `seed` | integer | ❌ | 随机种子，用于复现 |
| `prompt_optimizer` | boolean | ❌ | 自动优化 prompt，默认 false |
| `aigc_watermark` | boolean | ❌ | 添加水印，默认 false |
| `style` | object | ❌ | 仅 `image-01-live` 支持，画风设置 |

### style 画风参数（仅 image-01-live）
```json
{
  "style_type": "漫画|元气|中世纪|水彩",
  "style_weight": 0.8
}
```

## 响应
```json
{
  "id": "任务ID",
  "data": {
    "image_urls": ["https://..."],      // response_format=url
    "image_base64": ["base64..."]       // response_format=base64
  },
  "metadata": {
    "success_count": 1,
    "failed_count": 0
  },
  "base_resp": { "status_code": 0, "status_msg": "success" }
}
```

## 错误码
- `0` — 成功
- `1002` — 限流
- `1004` — 鉴权失败
- `1008` — 余额不足
- `1026` — 内容涉敏
- `2013` — 参数错误
- `2049` — 无效 key
- `2061` — 模型不支持（key 无权限）

## 常用调用示例

### curl（base64）
```bash
curl -X POST https://api.minimaxi.com/v1/image_generation \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "sci-fi mecha robot, neon lights",
    "aspect_ratio": "16:9",
    "response_format": "base64"
  }'
```

### curl（url）
```bash
curl -X POST https://api.minimaxi.com/v1/image_generation \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "sci-fi mecha robot, neon lights",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'
```
