# image2-studio

**Repository Path**: dllm7tou/image2-studio

## Basic Information

- **Project Name**: image2-studio
- **Description**: Image2 Studio — AI 图片生成与编辑桌面工具。基于 CustomTkinter，支持文生图和图文生图（编辑），兼容 OpenAI 格式 API。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Image2 Studio

AI 图片生成与编辑桌面工具，基于 CustomTkinter 构建，兼容 OpenAI 格式的生图 API。

## 功能

- **文生图** — 输入描述文字，生成图片
- **图文生图（编辑）** — 基于已有图片，通过描述修改内容、风格、背景等
- **参考图** — 支持多张参考图辅助生成
- **流式返回** — 逐步展示生成进度
- **历史记录** — 自动保存历史生成记录，可预览和复用
- **风格预设** — 内置水彩、油画、赛博朋克等 12 种风格
- **提示词模板** — 快速插入/替换品质描述模板
- **深色/浅色主题** — 一键切换
- **背景移除/替换** — 内置 AI 编辑功能
- **画布操作** — 缩放、平移、撤销/重做

## 截图

（待补充）

## 快速开始

### 环境要求

- Python 3.10+
- Windows / macOS / Linux

### 安装依赖

```bash
pip install customtkinter httpx Pillow
```

### 启动

```bash
python gpt_image_app.py
```

Windows 下也可双击 `启动图片生成器.bat`。

## API 配置

首次使用需要在 API 设置中配置接口地址和认证 Token。

点击右上角 ⚙ 按钮打开设置：

| 字段 | 说明 |
|------|------|
| 生成接口地址 | 文生图接口，指向 `/v1/images/generations` |
| 编辑接口地址 | 图生图编辑接口，指向 `/v1/images/edits`，留空则与生成共用 |
| 模型 | 默认为 `gpt-image-2` |
| 认证 Token | `Bearer <token>` 格式 |

### 接口说明

**生成（文生图）**
```
POST {api_base}/v1/images/generations
```
请求体：
```json
{
  "model": "gpt-image-2",
  "prompt": "生成一只橘猫宇航员贴纸",
  "size": "1024x1024",
  "quality": "high",
  "response_format": "b64_json"
}
```

**编辑（图生图）**
```
POST {api_edit_base}/v1/images/edits
```
请求体与生成类似，额外包含 `image_urls` 字段传入原图数据。

### 环境变量

支持通过环境变量覆盖默认配置：

| 变量名 | 说明 |
|--------|------|
| `GPT_IMAGE_API_BASE` | 生成接口地址 |
| `GPT_IMAGE_API_EDIT_BASE` | 编辑接口地址 |
| `GPT_IMAGE_MODEL` | 模型名称 |
| `GPT_IMAGE_AUTH` | 认证 Token |
| `GPT_IMAGE_SIZE` | 默认尺寸 |
| `GPT_IMAGE_QUALITY` | 默认质量 |
| `GPT_IMAGE_STYLE` | 默认风格 |

## 使用指南

1. 在左侧输入框中描述你想生成的图片
2. （可选）选择风格预设和品质模板
3. 点击「生成图片」
4. （可选）生成后点击「基于当前图片修改」，输入修改描述进行编辑
5. 支持添加参考图辅助生成

### 快捷键

- 右键点击画布 — 保存、复制、清空等操作菜单

## 项目结构

```
gpt_image_app.py          # 主程序
gpt_image_app_config.json # 配置文件
history_db.json           # 历史记录数据库
history/                  # 历史图片存储目录
启动图片生成器.bat         # Windows 快捷启动
```

## 常见问题

**启动报错 `ValueError: ['placeholder_text'] are not supported arguments`**

CustomTkinter 版本过低，需要 5.3+。当前项目已内置手动 placeholder 兼容方案，请确保安装的版本 ≥ 5.2。

**连接测试失败**

- 确认 API 地址和 Token 正确
- 可在终端中先用 curl 测试鉴权：
  ```bash
  curl {api_base}/v1/models -H "Authorization: Bearer <token>"
  ```

**生图返回慢**

生图任务通常需要 15-60 秒，大尺寸或高质量图片可能更久。程序会自动轮询等待任务完成。

## License

MIT