# AI图片处理工具

**Repository Path**: kuwx/ai-image-processing-tool

## Basic Information

- **Project Name**: AI图片处理工具
- **Description**: AI生图、改图、去水印、图片裁剪、图片压缩功
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-10
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎨 AI Image Studio (在线 AI 图片工具箱平台)

> **纯 Python 单语言全栈驱动**，零前端编译依赖，整合 **阶跃星辰（StepFun）线上大模型算力** 与 **本地纯 CPU 极速轻量引擎** 的一体化现代图片处理平台。

---

## ✨ 核心特色

1. **纯单语言零杂质（100% Python 全栈）**
   - 彻底告别 Java 调 Python、多服务进程通信与繁琐维护。
   - 统一由 FastAPI 驱动后端 REST API、模型调度与现代化暗黑玻璃拟态 Web 工作台，无需安装 Node.js/NPM，一条命令即可启动。
2. **线上大模型算力 (支持市面任意主流服务商，双模型独立解耦配置)**
   - 💬 **大语言模型 (LLM)**：支持 **DeepSeek (V3/R1)**、**阶跃星辰 (step-3.7-flash)**、**硅基流动**、**通义千问**、**Kimi**、**OpenAI** 等，专门负责提示词智能润色与画面构思。
   - 🎨 **AI 生图大模型 (Image)**：支持 **阶跃星辰 (step-image-edit-2)**、**硅基流动 (FLUX.1/SD 3.5)**、**OpenAI (DALL-E 3)**、**通义万相**、**智谱 CogView** 等，支持文生图与以图改图。
   - ⚡ **独立分开配置 & 热门预设一键填入**：两者拥有完全独立的 Base URL、API Key 与 Model ID，点击预设芯片即可秒级填入，免去查文档找地址的繁琐过程。
3. **本地纯 CPU 极速引擎（免独立显卡）**
   - 🪄 **AI 去背景 / 证件照换底**：轻量 ONNX 运行时（`u2netp` 模型仅 4MB），普通 CPU **0.15 秒极速抠图**，支持透明 PNG 导出及一键切换红/蓝/白/黑证件照底色。
   - 🧹 **涂抹消除文字与水印**：交互式画笔涂抹遮罩 + **LaMa 本地 AI 修复模型**（纯 CPU、离线、图片不上传，复杂纹理背景也能自然重建），并保留 Telea / NS 经典快速算法可选，局部区域自动裁剪修复以保证速度。
   - ✂️ **裁剪与变换**：自由裁剪、1:1 正方形、16:9 宽屏、9:16 短视频等比例预设，支持 90° 旋转与镜像翻转。
   - 🗜️ **极限压缩与转码**：WebP / JPG / PNG 格式互转与质量滑块控制，实测体积减少高达 **80%~85%**。
4. **极致交互与全流程流水线 (Pipeline)**
   - 🎚️ **Before / After 对比滑块**：像素级 1:1 绝对对齐，左右拖拽即可查看处理前后的惊艳变化。
   - 📥 **多格式导出下载与剪贴板一键复制**：支持保存为 PNG/JPG/WebP，支持一键将高保真图片写入系统剪贴板，直接在微信/文档中按 `Ctrl + V` 粘贴。
   - ⚙️ **可视化模型配置面板**：支持随时在前端查看、脱敏修改 API Key、Base URL 及模型 ID。

---

## 🛠️ 项目架构

```text
ai-image-processing-tool/
├── app/
│   ├── api/
│   │   ├── __init__.py        # 统一路由挂载
│   │   ├── generate.py        # AI 生图、改图、提示词优化路由
│   │   ├── matting.py         # AI 抠图与换底色路由
│   │   ├── inpaint.py         # 涂抹去水印与消除路由
│   │   ├── process.py         # 裁剪变换与压缩转码路由
│   │   └── config.py          # 模型配置动态管理接口
│   ├── core/
│   │   └── config.py          # 统一系统与模型设置
│   ├── services/
│   │   ├── stepfun_service.py # StepFun 线上模型封装
│   │   ├── matting_service.py # CPU 轻量抠图引擎
│   │   ├── inpaint_service.py # 智能修补消除引擎
│   │   └── image_service.py   # 图像几何变换与压缩优化
│   └── static/                # 现代化单页应用 (由 FastAPI 托管)
│       ├── css/style.css      # 暗黑玻璃拟态主题样式
│       ├── js/canvas.js       # 涂抹遮罩 Canvas 模块
│       ├── js/cropper.js      # 交互式裁切框组件
│       ├── js/app.js          # 主控制台逻辑与工作流
│       └── index.html         # 响应式 Web 入口
├── main.py                    # 平台统一启动入口
├── requirements.txt           # Python 依赖清单
├── .env.example               # 配置模板示例 (脱敏)
└── .gitignore                 # 安全忽略规则 (严防私有 Key 泄露)
```

---

## 🚀 快速上手

### 1. 克隆代码
```bash
git clone https://gitee.com/kuwx/ai-image-processing-tool.git
cd ai-image-processing-tool
```

### 2. 安装依赖
```bash
pip install -r requirements.txt
```

### 3. 配置密钥（两种方式任选）
- **方式一（推荐）**：启动服务后，直接在网页右上角点击 **【⚙️ 模型配置】**，输入你的 StepFun API Key 即可保存并实时生效！
- **方式二**：复制配置模板：
  ```bash
  cp .env.example .env
  ```
  在 `.env` 文件中填入你的 `STEP_API_KEY`。

### 4. 启动平台
```bash
python main.py
```
终端将输出：
```text
🚀 AI Image Studio 正在启动...
🌐 访问地址: http://127.0.0.1:8000
📖 API 文档: http://127.0.0.1:8000/docs
⚙️ 模式: 纯 CPU 本地推理 + StepFun 线上模型 (step-image-edit-2)
```

用浏览器访问 **http://localhost:8000** 即可尽情使用！

---

## 📄 License
MIT License