Skip to content

docs: refresh README for current provider workflows #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Aswellle merged 1 commit into from
Jul 21, 2026
Merged

docs: refresh README for current provider workflows #1

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 27 additions & 20 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
╚══════════════════════════════════════════════════════╝
```

**桌面 AI 图片生成器 · 聚合 17 个免费与付费生图接口**
**桌面 AI 图片生成器 · 内置 22 个免费、付费及商用生图服务实现**

[![CI](https://github.com/Aswellle/2image/actions/workflows/ci.yml/badge.svg)](https://github.com/Aswellle/2image/actions)
[![Release](https://img.shields.io/github/v/release/Aswellle/2image)](https://github.com/Aswellle/2image/releases/latest)
Expand All @@ -37,17 +37,17 @@

## ✨ 核心亮点

### 🎯 一个界面，17 个接口
同时接入 Pollinations、硅基流动、Gemini、Cloudflare、fal.ai、DALL-E 3 等 17 个主流生图服务。**免费的先用，付费的按需开通**，接口故障自动切换，生成从不中断。
### 🎯 一个界面，19 个可选接口
主界面可直接选择 19 个免费与付费生图服务，覆盖 Pollinations、硅基流动、Gemini、通义万相、Bria AI、OpenAI GPT-Image 与 Black Forest Labs FLUX 等。**可先使用无需 Key 的服务，再按需配置免费或付费 API**；生成会按当前优先序列依次尝试可用服务。另有 3 个商用服务实现，见下方说明。

### 🆓 零成本起步
**Pollinations.AI 完全免费、无需注册**，开箱即用。注册几个免费账号后还能解锁更多高质量模型，日均数百张的创作需求无需花一分钱。
**Pollinations.AI 无需注册即可体验**，开箱即用；匿名调用仍受频率限制。注册几个提供免费额度的服务后，还能解锁更多高质量模型，覆盖日常创作需求。

### 🧠 智能路由，一键最优
输入「banner 设计」自动优先 Ideogram（擅长文字入图）；输入「电商产品图」自动优先 fal.ai FLUX Ultra（写实高清）。不同场景用最合适的模型，无需手动切换。
配置可用服务后，输入「banner 设计」会优先排列 Ideogram（擅长文字入图）；输入「电商产品图」会优先排列 fal.ai FLUX Ultra（写实高清）。不同场景按优先序列尝试适合的模型，也可手动指定接口。

### 🖼 图生图（img2img）
上传参考图，调整「变化强度」，让 AI 在保留原图风格的基础上进行创作。支持 Stability AI 和 fal.ai 等主流图生图接口。
上传参考图后，程序会只显示已接入且已有配置入口的图生图接口；可使用 Stability AI 的「变化强度」控制改动幅度，其他支持的模型会一并接收参考图。当前可选 Stability AI、Google Gemini Nano Banana、Nano Banana Pro、OpenAI GPT-Image、MiniMax image-01 与 Black Forest Labs FLUX 等服务；批量变体和顺序队列会在图生图模式下自动锁定，避免参考图被忽略。

### 🎲 批量变体，一次生成 6 张
同一提示词自动生成多张不同种子的变体，对比挑选最满意的一张，极大提升创作效率。支持标准模式与高质量模式（更高步数 / 更好模型）。
Expand All @@ -56,7 +56,7 @@
将多个任务加入队列，让程序按顺序自动生成。可随时暂停、继续或停止，中途新增任务也会自动纳入当前轮次。

### 🔧 AI 提示词优化
内置 DeepSeek V3 提示词优化向导（通过硅基流动 LLM 接口调用），帮助你把模糊想法转化为高质量的英文提示词，无需 DeepSeek 独立账号。
内置提示词优化向导，可将模糊想法整理成高质量英文提示词。填写硅基流动 Key 后会按 DeepSeek V3、Qwen 与 GLM 候选顺序尝试；也可填写 DeepSeek 官方 API Key，手动选择质量优先的 Pro 或速度优先的 Flash 预设。未配置硅基流动时，可改用 HuggingFace 通道。

### 🀄 中文原生支持
直接输入中文描述，程序自动调用 MyMemory 翻译为英文再送入生图接口——无需手动翻译，无需额外配置。
Expand Down Expand Up @@ -92,31 +92,38 @@ python main.py

| 接口 | 模型 | 免费额度 | 是否需要 Key |
|---|---|---|---|
| **Pollinations.AI** | FLUX Schnell | 无限制 | ❌ 无需注册 |
| **Pollinations.AI** | FLUX Schnell | 无固定日配额，匿名调用有频率限制 | ❌ 无需注册 |
| **硅基流动 SiliconFlow** ⭐ | FLUX.1-dev/schnell · SDXL | 注册送免费额度 | ✅ 免费注册 |
| **Google Gemini** | Gemini 2.5 Flash Image | 500 次/天 | ✅ 免费注册 |
| **Cloudflare Workers AI** | FLUX.1-schnell | 1 万次/天 | ✅ 免费注册 |
| **HuggingFace** | FLUX · SDXL | 免费推理 API | ✅ 免费注册 |
| **Google Gemini** | Gemini 2.5 Flash Image（Nano Banana） | 以 Google AI Studio 当前免费额度为准 | ✅ 免费注册 |
| **通义万相 Qwen-Image** | wanx2.1-t2i-turbo | 阿里云新用户免费额度 | ✅ 免费注册 |
| **Bria AI Fibo** | Fibo | 注册送 1000 次调用 | ✅ 免费注册 |
| **Cloudflare Workers AI** | FLUX.1-schnell | 1 万 Neurons/天（约 10–20 张高分辨率图） | ✅ 免费注册 |
| **HuggingFace** | FLUX · Stable Diffusion 3 Medium | 免费推理 API | ✅ 免费注册 |
| **StableHorde** | SD 系列 | 匿名可用 | ❌ 可选注册 |
| **ModelsLab** | FLUX · SDXL | 100 次/天 | ✅ 免费注册 |
| **Together AI** | FLUX.1-schnell-Free | 免费端点 | ✅ 免费注册 |
| **OpenRouter** | 多种免费模型 | 部分模型免费 | ✅ 免费注册 |
| **Together AI** | FLUX.1-schnell | 免费可用性请以 Together 控制台为准 | ✅ 免费注册 |
| **OpenRouter** | 统一 Image API | 按所选模型计费，免费可用性请以模型页为准 | ✅ 免费注册 |
| **Segmind** | FLUX · SDXL | 注册送 $5 额度 | ✅ 免费注册 |

### 付费接口

| 接口 | 特点 | 定价参考 |
|---|---|---|
| **💎 OpenAI DALL-E 3** | 高质量写实 / 插画，提示词服从度极高 | 按次计费 |
| **💎 OpenAI GPT-Image** | 文生图与参考图编辑，支持 gpt-image-1 / mini | 按次计费 |
| **💎 Nano Banana Pro** | Gemini 3 Pro Image，高画质图生图，复用 Gemini Key | 按量计费 |
| **💎 MiniMax image-01** | 文生图与主体参考图创作 | 按量计费 |
| **💎 Black Forest Labs FLUX** | 官方 FLUX 文生图与 Kontext 图生图 | 按量计费 |
| **💎 Stability AI** | 支持图生图，Stable Diffusion 原厂 | 按次计费 |
| **💎 Replicate FLUX** | FLUX.1-pro 高分辨率 | 按次计费 |
| **💎 xAI Grok Imagine** | Aurora 模型，注册送 $25 免费额度 | 按次计费 |
| **💎 Replicate FLUX** | FLUX.1.1 Pro 高分辨率 | 按次计费 |
| **💎 xAI Grok Imagine** | Grok Imagine Image Quality 模型 | 按次计费 |

### 商业变现接口

以下服务已由注册表自动发现；当前尚未接入常规的主界面下拉菜单与密钥配置向导，适合需要自行补充配置入口的商用场景。

| 接口 | 特点 |
|---|---|
| **Ideogram v2** | 文字入图首选，Banner / LOGO / 海报中文字可读 |
| **Ideogram v3** | 文字入图首选，Banner / LOGO / 海报中文字可读 |
| **fal.ai FLUX Ultra** | 最高 4MP 超清写实，产品图 / 人像首选 |
| **Recraft v3** | 设计 / 插画 / 矢量风格，品牌 VI 利器 |

Expand All @@ -129,7 +136,7 @@ main.py
└─ config/ 配置层：路径 · 主题 · 国际化 · 字体
└─ data/ 数据层：SQLite 历史（WAL 模式，线程安全）
└─ services/ 服务层：调度 · 路由 · 翻译 · 提示词优化
│ └─ providers/ 17 个接口实现（pkgutil 自动发现，无需手动注册）
│ └─ providers/ 22 个接口实现（pkgutil 自动发现，无需手动注册）
└─ ui/ 表现层：Tkinter 暗色主题，通过 Protocol 接口解耦
```

Expand All @@ -139,7 +146,7 @@ main.py

## 🔌 扩展新接口

只需新建一个文件，框架自动发现：
只需新建一个免费或付费接口文件，框架自动发现：

```python
# services/providers/my_api.py
Expand All @@ -158,7 +165,7 @@ def try_my_api(prompt, w, h, seed, cfg, log):
return image_bytes, "我的接口"
```

无需修改任何其他文件，接口自动出现在 UI 下拉菜单和智能路由中。
免费或付费接口会自动出现在 UI 下拉菜单和智能路由中。商用分类也会被自动注册，可按项目的商用接口接入方式继续扩展。

---

Expand Down
Loading