# MinimaxImageStudio

**Repository Path**: snxa/minimax-image-studio

## Basic Information

- **Project Name**: MinimaxImageStudio
- **Description**: 使用minimax能力创建图片的一个工具
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiniMax Image Studio

基于 [MiniMax](https://platform.minimaxi.com/) 图片生成 API 的纯静态 Web 工作台,无框架、无构建、双击即用。

![Tech](https://img.shields.io/badge/HTML-CSS-JS-blue) ![Deps](https://img.shields.io/badge/dependencies-0-green) ![Theme](https://img.shields.io/badge/theme-dark--purple--cyan-purple)

## 功能特性

### 创作
- **文生图 / 图生图**双模式切换
- **批量生成**(1-9 张/次),自动并发调度(最多 2 并发,超出排队)
- **种子(seed)复现**:固定种子可复现同一构图色调
- **官方 Prompt 自动优化**:可选开关,让 API 帮你补全细节
- **多种宽高比**:1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 4:7 / 7:4

### AI 技能
- **提示词润色**:一句话改写成专业摄影/艺术描述,左右对比 + 一键采纳
- **图片理解反推提示词**:上传图片或从作品库选择,AI 分析后给出参考 prompt
- **多模态识别**:基于 `MiniMax-M3`,支持文+图混合输入

### 作品管理
- **永久本地存储**:图片保存到 IndexedDB,刷新页面不丢失
- **灯箱查看**:滚轮缩放、拖动平移、键盘 ← → 切换、ESC 关闭
- **批量选择 + 下载**:打包成 zip 一键下载
- **批量删除**:一键清理
- **作品元信息**:显示模型、宽高比、种子、创建时间

### 安全
- **API Key AES-GCM 加密** 存浏览器,不落盘、不上云
- 设备绑定:清除浏览器数据后需重新输入
- 无 Key 时 AI 入口禁用,不提供 mock 数据

## 快速开始

### 1. 启动本地服务
```bash
cd minimax-image-studio
python -m http.server 8765
```
浏览器打开 http://localhost:8765/index.html

> 必须用 HTTP 服务器打开,**不能用 file://**,因为:
> - `crypto.subtle` 加密 API 需安全上下文(https/localhost)
> - 图片本地化(fetch 远程 URL)需要 CORS 友好的上下文

### 2. 配置 API Key
点击右上角"API Key 设置",填入 MiniMax 平台获取的 API Key,点击"测试连接"。

### 3. 开始创作
1. 选择模式(文生图 / 图生图)
2. 输入提示词(图生图需上传参考图)
3. 点击"生成"
4. 在作品库查看结果,点击图片放大查看

## 截图
(部署后可补充)

## 技术栈
- **前端**:HTML + CSS + 原生 JS(ES2020+),无任何框架
- **图标**:[lucide](https://lucide.dev/) (CDN)
- **打包**:无,单文件 SPA
- **存储**:localStorage + IndexedDB
- **加密**:Web Crypto API(AES-GCM 256)
- **压缩**:JSZip(批量下载)

## 仓库结构
```
minimax-image-studio/
├── index.html               # 入口 + 内联全部 CSS(设计令牌、3-zone shell、组件样式)
├── app.js                   # 主逻辑(加密/状态/调度/渲染/事件/API/AI 技能)
├── README.md                # 本文件
├── CLAUDE.md                # AI 编程助手指引
├── .gitignore               # API Key 文件防御规则
└── .trae/
    ├── documents/           # 开发计划 + 设计升级方案
    └── skills/
        └── minimax-image-api/SKILL.md   # API 速查 + prompt 模板
```

## API 接口
项目调用 MiniMax 平台两个端点:

| 端点 | 用途 | 模型 |
|---|---|---|
| `POST /v1/image_generation` | 文生图 / 图生图批量生成 | `image-01` |
| `POST /v1/text/chatcompletion_v2` | 提示词润色 + 图片理解(多模态) | `MiniMax-M3` |

详细参数与 prompt 模板见 [.trae/skills/minimax-image-api/SKILL.md](.trae/skills/minimax-image-api/SKILL.md)。

## 设计风格
- **配色**:暗色主题,紫蓝渐变 `#7B5CFF → #00D4FF`,玻璃拟态质感
- **字体**:Space Grotesk(品牌) + Inter(正文) + JetBrains Mono(代码/元数据)
- **布局**:3-zone shell — 侧栏 / 创作区 / 任务队列

## 常见问题

**Q: API Key 存在哪里?**
A: 浏览器 localStorage + IndexedDB,用 AES-GCM 加密。清除浏览器数据后需重新输入。

**Q: 为什么不开 file:// 直接打开?**
A: 浏览器 Web Crypto API 需要安全上下文,本地 file:// 不满足条件。

**Q: 随机种子(seed)有什么用?**
A: 同一 seed + 同一 prompt 会生成高度相似的图片,用于复现满意作品或批量保持一致性。

**Q: 图片会保存多久?**
A: 永久。生成完成后立即下载为 Blob 存到 IndexedDB,与 API 返回的临时 URL(24h 失效)解耦。

**Q: 并发上限是多少?**
A: `MAX_CONCURRENT_RUNNING = 2`,超出任务自动排队等待。

## 开发
- 改完文件直接刷新浏览器,无热更新
- 语法检查:`node -c app.js`
- 调试持久化:DevTools → Application → Local Storage / IndexedDB(`mmx-img-studio-db`)
- Console 输入 `state` 查看当前运行时状态

## 路线图
- [ ] WebSocket 流式接收(若有 API 升级)
- [ ] 视频生成支持
- [ ] 作品分享链接(可选)
- [ ] PWA 离线可用

## 许可证
MIT

## 致谢
- [MiniMax](https://platform.minimaxi.com/) 提供图片生成与多模态 API
- [lucide](https://lucide.dev/) 提供图标库