image-generator/README.md

图片生成器

MiniMax 文生图工具，访问 http://域名或IP:8195

---

一键部署

# SSH 登录目标机器后，一键运行：
bash <(curl -fsSL https://gitea.zwbcc.cn/zwbpc/image-generator/raw/branch/master/start.sh)

或手动部署：

# 1. 安装依赖
npm i -g express node-fetch

# 2. 下载项目（到 /home/zwbpc/image-generator 或其他目录）
git clone https://gitea.zwbcc.cn/zwbpc/image-generator.git
cd image-generator

# 3. 启动
chmod +x start.sh
./start.sh

# 4. 配置开机自启（可选）
# 创建 service：~/.config/systemd/user/image-generator.service
# 内容见下方「Systemd」小节
systemctl --user daemon-reload
systemctl --user enable --now image-generator.service

访问： http://域名或IP:8195

配置 API Key： 页面右上角 ⚙️ → 填入 MiniMax Key → 保存

---

Systemd Service（可选）

# ~/.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

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user enable --now image-generator.service

---

项目结构

image-generator/
├── index.html   # 前端
├── style.css    # 样式
├── app.js       # 服务端（Express）
├── start.sh     # 启动脚本
├── config.json  # API Key 存储（自动生成）
└── CHANGELOG.md

---

API 端点

方法	路径	说明
POST	/api/generate	生成图片
GET	/api/config	获取配置
POST	/api/config	保存配置

生成参数：

参数	默认值	说明
model	image-01	image-01 或 image-01-live
prompt	—	图片描述（必填）
aspect_ratio	16:9	比例：1:1 16:9 4:3 3:2 2:3 3:4 9:16 21:9
response_format	url	url（24h有效）或 base64
n	1	数量 1-9
seed	随机	整数，用于复现
width / height	—	自定义分辨率（512-2048，8的倍数）
style.style_type	—	画风：漫画 元气 中世纪 水彩（仅 live）
style.style_weight	0.8	画风权重 0.1-1.0（仅 live）

常见错误码： 1002限流 1004鉴权失败 1008余额不足 1026敏感词 2049无效Key