# 图片生成器

基于 MiniMax API 的文生图 Web 界面，支持 `image-01` 和 `image-01-live` 双模型。

**本地访问：** http://10.0.10.110:8195

---

## 功能特性

### 模型

| 模型 | 说明 |
|------|------|
| `image-01` | 标准文生图，支持全部比例和自定义分辨率 |
| `image-01-live` | 支持画风类型，适合风格化创作 |

### 图片参数

- **比例**：1:1 / 16:9 / 4:3 / 3:2 / 2:3 / 3:4 / 9:16 / 21:9（仅 image-01）
- **自定义分辨率**：宽度 × 高度，512-2048，必须为 8 的倍数；同时设置宽高时优先于比例
- **输出格式**：URL（24小时有效）或 Base64（直接保存）
- **生成数量**：1-9 张
- **随机种子**：输入整数用于复现，留空则随机

### 画风（仅 image-01-live）

| 画风 | 说明 |
|------|------|
| 漫画 | 漫画风格 |
| 元气 | 活力元气风格 |
| 中世纪 | 中世纪风格 |
| 水彩 | 水彩画风格 |

权重 0.1-1.0 通过滑块调节。

### 高级选项

- **自动优化 Prompt**：启用后自动优化描述
- **添加 AI 水印**：在图片中嵌入 MiniMax 水印

---

## API Key 配置

首次使用需配置 MiniMax API Key：

1. 点击右上角 ⚙️ 设置按钮
2. 填写 API Key（格式：`eyJhbGciOiJIUzI1NiIsInR5...`）
3. API 地址默认 `https://api.minimaxi.com`（中国区），仅在需要代理时修改
4. 点击保存

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

Key 存储在 `config.json` 中（服务进程内存，不暴露给前端）。

---

## 部署

### 环境依赖

- Node.js（已安装）
- 全局模块：`express`、`node-fetch`

```bash
# 检查依赖
npm root -g    # 查看全局模块路径
node -e "require('express'); require('node-fetch')"   # 验证
```

### Systemd Service

```ini
# ~/.config/systemd/user/image-generator.service
[Unit]
Description=MiniMax Image Generator
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/zwbpc/image-generator
ExecStart=/home/zwbpc/image-generator/start.sh
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
```

```bash
# 启用并启动
systemctl --user daemon-reload
systemctl --user enable --now image-generator.service

# 重启
systemctl --user restart image-generator.service

# 查看日志
journalctl --user -u image-generator.service -n50 -f
```

### 手动启动

```bash
cd /home/zwbpc/image-generator
export NODE_PATH=$(npm root -g)
node app.js
```

---

## 接口

### `POST /api/generate`

生成图片。

**请求体：**

```json
{
  "model": "image-01",
  "prompt": "一只赛博朋克风格的小猫",
  "aspect_ratio": "16:9",
  "response_format": "url",
  "n": 1
}
```

| 参数 | 类型 | 说明 |
|------|------|------|
| `model` | string | `image-01` 或 `image-01-live` |
| `prompt` | string | 图片描述，最多 1500 字符 |
| `aspect_ratio` | string | 比例，如 `16:9` |
| `width` | number | 自定义宽度（512-2048，需同时设置 height） |
| `height` | number | 自定义高度（512-2048，需同时设置 width） |
| `response_format` | string | `url` 或 `base64` |
| `n` | number | 生成数量 1-9 |
| `seed` | number | 随机种子，用于复现 |
| `prompt_optimizer` | boolean | 自动优化 Prompt |
| `aigc_watermark` | boolean | 添加 AI 水印 |
| `style.style_type` | string | 画风类型（仅 image-01-live） |
| `style.style_weight` | number | 画风权重 0.1-1.0（仅 image-01-live） |

**响应：**

```json
{
  "images": ["https://..."],
  "id": "task_xxx",
  "success_count": 1,
  "failed_count": 0
}
```

### `GET /api/config`

获取当前配置（不含 Key）。

### `POST /api/config`

保存配置。

### `GET /api/task/:id`

查询任务状态（预留）。

---

## 常见错误

| 错误码 | 说明 |
|--------|------|
| 1002 | 限流，请稍后再试 |
| 1004 | 账号鉴权失败，检查 API Key |
| 1008 | 账号余额不足 |
| 1026 | 内容涉及敏感词，修改 Prompt |
| 2013 | 参数异常，检查输入是否合规 |
| 2049 | 无效的 API Key |

---

## 项目结构

```
image-generator/
├── index.html    # 前端页面
├── style.css     # 样式（深色主题）
├── app.js        # Express 服务端
├── config.json   # API Key 存储（不提交）
├── start.sh      # 启动脚本（设置 NODE_PATH）
└── CHANGELOG.md  # 更新日志
```

---

## 更新日志

参见 [CHANGELOG.md](./CHANGELOG.md)