image-generator/README.md

图片生成器

MiniMax 文生图工具，基于 image-01 模型。

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

---

部署

环境要求

• Node.js >= 18
• npm

一键部署

# 克隆 + 安装依赖 + 启动
git clone https://gitea.zwbcc.cn/zwbpc/image-generator.git /home/zwbpc/image-generator \
  && cd /home/zwbpc/image-generator \
  && npm i -g express node-fetch \
  && chmod +x start.sh \
  && ./start.sh

配置开机自启（可选）

# 创建 service 文件
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/image-generator.service << 'EOF'
[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
EOF

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

重启服务： systemctl --user restart image-generator.service

---

配置

首次使用需填写 API Key：

1. 访问页面右上角 ⚙️ 设置
2. 填入 MiniMax API Key（格式：eyJhbGciOiJIUzI1NiIsInR...）
3. API 地址默认 https://api.minimaxi.com，无需修改
4. 保存

获取地址：https://platform.minimaxi.com/user-center/payment/token-plan

---

项目结构

image-generator/
├── index.html   # HTML 页面
├── style.css   # 样式（深色主题）
├── ui.js       # 前端交互逻辑
├── app.js      # 服务端（Express）
├── start.sh    # 启动脚本
├── config.json # API Key 存储（不提交，自动生成）
└── CHANGELOG.md

---

API 接口

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

生成参数

参数	默认	说明
model	image-01	模型，目前仅支持 image-01
prompt	必填	图片描述，最多 1500 字符
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的倍数）

常见错误

错误码	说明
1002	限流，稍后重试
1004	API Key 错误
1008	余额不足
1026	内容含敏感词，修改 Prompt
2049	无效的 API Key