颜AI 是一个围绕 ChatGPT 图片能力封装的自托管图片创作与管理系统，提供 OpenAI 兼容图片 API、在线画图工作台、图生图预设、账号池轮询、个人用户额度、渠道管理、模型管理、计费标准配置、图片归档、日志与 Docker 部署能力。
Warning
免责声明：
本项目涉及对 ChatGPT 官网文本生成、图片生成与图片编辑等相关接口的逆向研究，仅供个人学习、技术研究与非商业性技术交流使用。
- 严禁将本项目用于任何商业用途、盈利性使用、批量操作、自动化滥用或规模化调用。
- 严禁将本项目用于破坏市场秩序、恶意竞争、套利倒卖、二次售卖相关服务，以及任何违反 OpenAI 服务条款或当地法律法规的行为。
- 严禁将本项目用于生成、传播或协助生成违法、暴力、色情、未成年人相关内容，或用于诈骗、欺诈、骚扰等非法或不当用途。
- 使用者应自行承担全部风险，包括但不限于账号被限制、临时封禁或永久封禁以及因违规使用等所导致的法律责任。
- 使用本项目即视为你已充分理解并同意本免责声明全部内容；如因滥用、违规或违法使用造成任何后果，均由使用者自行承担。
Important
本项目基于对 ChatGPT 官网相关能力的逆向研究实现，存在账号受限、临时封禁或永久封禁的风险。请勿使用你自己的重要账号、常用账号或高价值账号进行测试。
Caution
旧版本存在已知漏洞，请尽快升级到最新版本。公网部署时请尽量不要放置敏感信息，并自行做好访问控制与隔离。
已发布镜像支持 linux/amd64 与 linux/arm64，在 x86 服务器和 Apple Silicon / ARM Linux 设备上都会自动拉取匹配架构的版本。
git clone git@github.com:huaiyuechusan/YanAI.git
cd YanAI
docker build -t your-registry/yanai:latest .
docker push your-registry/yanai:latest当前仓库的 Docker 镜像不会包含 config.json、data/、.env、数据库文件或本地虚拟环境。服务器部署时请通过宿主机挂载提供运行时配置和数据：
volumes:
- ./data:/app/data
- ./config.json:/app/config.json服务器上准备配置和数据目录：
cp config.example.json config.json
# 编辑 config.json，将 auth-key 改成你自己的长随机密钥
mkdir -p data
YANAI_IMAGE=your-registry/yanai:latest docker compose up -d也可以用环境变量 CHATGPT2API_AUTH_KEY 覆盖 config.json 中的 auth-key，但不要把真实密钥写进 Dockerfile、镜像构建参数或公开 compose 文件。
本地直接用当前代码启动容器可运行：
docker compose -f docker-compose.local.yml up -d --build本地开发启动
cd D:\Desktop\颜AI
.\.venv\Scripts\python.exe -m uvicorn main:app --reload --host 127.0.0.1 --port 8000
cd D:\Desktop\颜AI\web
npm run dev支持通过环境变量 STORAGE_BACKEND 切换存储方式：
json- 本地 JSON 文件（默认）sqlite- 本地 SQLite 数据库postgres- 外部 PostgreSQL（需配置DATABASE_URL）git- Git 私有仓库（需配置GIT_REPO_URL和GIT_TOKEN）
多人稳定并发部署建议使用 postgres。sqlite 适合本地开发和轻量验证；json / git 更适合单实例低并发、备份导入导出或过渡场景，不建议作为多人生产并发的主存储。
示例：使用 PostgreSQL
environment:
- STORAGE_BACKEND=postgres
- DATABASE_URL=postgresql://user:password@host:5432/dbname从旧 JSON 存储迁移到 SQLite、PostgreSQL 或 Git 前，必须先停写。Docker 部署请先停止 YanAI 容器，确认没有后台任务继续写入 data/*.json：
docker compose stop app
# 如果是按容器名直接管理，也可以使用：docker stop yanai先执行只读审计，确认 8 类旧 JSON 数据的数量、重复主键、缺失主键和异常 JSON：
python scripts/audit_storage.py --data-dir data生成完整 JSON 备份目录，并校验备份可恢复：
python scripts/backup_storage.py --data-dir data --backup-dir data/backups/pre-migration
python scripts/backup_storage.py --verify data/backups/pre-migration恢复演练可以写到临时目录，避免覆盖生产数据：
python scripts/backup_storage.py --restore data/backups/pre-migration --target-dir .tmp/restore-check
python scripts/audit_storage.py --data-dir .tmp/restore-check --fail-on-issues迁移脚本支持预演、迁移前备份和只校验模式：
python scripts/migrate_storage.py --from json --to postgres --dry-run
python scripts/migrate_storage.py --from json --to postgres --backup-dir data/backups/pre-postgres
python scripts/migrate_storage.py --from json --to postgres --verify-only- 兼容
POST /v1/images/generations图片生成接口 - 兼容
POST /v1/images/edits图片编辑接口 - 管理员密钥可调用
POST /v1/chat/completions、POST /v1/responses与POST /v1/messages GET /v1/models会返回上游模型列表，并补充内置默认模型gpt-5、gpt-5-1、gpt-5-2、gpt-5-3、gpt-5-3-mini、gpt-5-5、gpt-5-mini、gpt-image-2、codex-gpt-image-2、auto- 图片接口支持
n=1-4，前端工作台会按张数拆分任务执行 - 支持内置账号池与 OpenAI 图片兼容外部渠道，按模型、权重、优先级进行路由
- 支持 Codex 中的画图接口逆向，仅
Plus/Team/Pro订阅可用，模型别名为codex-gpt-image-2，用于和官网画图区分
- 内置「画图」工作台，支持文生图、图生图和多参考图编辑
- 提供眼镜搭配、发型报告、自然美颜、写真随机风格、照片增强、暗光修复、高清细节修复等预设提示词
- 支持参考图上传、粘贴图片、图片比例选择和多张任务队列
- 本地保存图片会话历史，支持回看、删除、清空和从结果图继续编辑
- 服务端可缓存生成图片，并在「图片管理 / 我的图片」中按日期筛选、预览和复制地址
- 自动刷新账号邮箱、类型、额度和恢复时间
- 轮询可用账号执行图片生成与图片编辑
- 遇到 Token 失效类错误时自动剔除无效 Token
- 定时检查限流账号并自动刷新
- 支持网页端配置全局 HTTP / HTTPS / SOCKS5 / SOCKS5H 代理
- 支持搜索、筛选、批量刷新、导出、手动编辑和清理账号
- 支持四种导入方式：本地 CPA JSON 文件导入、远程 CPA 服务器导入、
sub2api服务器导入、access_token导入 - 支持在设置页配置
sub2api服务器，筛选并批量导入其中的 OpenAI OAuth 账号
- 管理员可创建个人用户、调整额度、禁用账号、重置密码
- 支持个人用户注册、登录、兑换码领取额度，以及个人图片记录查看
- 支持 OpenAI 图片兼容渠道管理，可设置 Base URL、API Key、模型、权重、优先级和超时时间
- 支持模型管理，可按渠道汇总模型、从渠道
/v1/models获取模型列表，并为每个模型配置计费标准 - 支持系统日志查看、图片访问地址配置、自动清理天数、账号刷新间隔和模型映射配置
- 管理员可在「模型管理」页面查看所有渠道模型；内置账号池默认提供与 New API 接入常用配置一致的 10 个模型，外部渠道则读取渠道自身
models配置。 - 每个 OpenAI 兼容外部渠道都可以通过「获取」按钮请求该渠道的
/v1/models，成功后自动写回渠道模型列表。 - 模型计费配置保存在系统配置
model_pricing中，兼容 JSON、SQLite、PostgreSQL 等现有存储后端，不需要额外迁移表结构。 - 计费标准支持按 Token 和按次两种模式；可配置输入价 / 1M tokens、输出价 / 1M tokens、
model_ratio、completion_ratio、model_price、币种和启停状态，方便对接 New API 风格的倍率或固定价格计费。
当前仓库已经完成多用户稳定并发改造，核心依赖数据库事务、行级写入、租约和请求追踪。
- 存储层拆分为 Repository 边界，并保留兼容旧 Storage API 的适配器；数据库后端覆盖账号、管理员密钥、用户、会话、兑换码、渠道、提示词库、图片记录、额度预留、系统配置、系统日志和审计日志等数据集
- 数据迁移和安全保护覆盖完整业务数据，提供只读审计、备份恢复、迁移预演、迁移校验和重复主键检查，支持从旧 JSON 数据迁移到 SQLite / PostgreSQL
- 普通用户图片额度改为请求级预扣：任务开始前按
request_id预留额度，成功后按实际生成数量确认，失败或无结果时释放，过期预留由后台 watcher 返还；管理员调用不占用个人额度 - 账号池改为图片任务租约模型，支持
max_concurrency、inflight_count、lease_owner、lease_owners和leased_until，租用成功后再调用上游，结束时释放并更新成功、失败、额度和限流状态；PostgreSQL 下会使用行级锁避免多个任务抢占同一账号 - 图片记录改为逐条插入并使用 UUID 记录 ID，支持按用户、日期、渠道和
request_id分页查询，避免多人同时生成图片时整表覆盖导致记录丢失 - 兑换码兑换、渠道更新、提示词新增和系统设置已接入数据库 Repository：单次兑换码并发兑换只能成功一次，不同渠道或提示词的并发管理操作不会互相覆盖
- 请求链路加入
x-request-id/request_id，贯穿 API 调用、额度预留、账号租约、图片记录、系统日志和审计日志；/api/storage/info和健康检查可查看当前存储后端与数据集状态
注册机支持在 /register 页面配置多个临时邮箱 provider，并按启用顺序轮换。moemail 配置示例：
{
"enable": true,
"type": "moemail",
"api_base": "https://moemail.app",
"api_key": "YOUR_MOEMAIL_API_KEY",
"default_domain": "moemail.app",
"expiry_time": 3600000
}api_base 可以改为你自部署的 MoeMail 地址；expiry_time 单位为毫秒，3600000 表示 1 小时。
- 文本类兼容接口主要面向管理员密钥和调试场景，个人用户仅开放图片相关能力
- 流式图片与文本输出仍建议谨慎测试
- 详细状态说明见：功能清单
所有 AI 接口都需要请求头：
Authorization: Bearer <auth-key>GET /v1/models
返回上游模型列表，并补充当前内置默认模型。
curl http://localhost:8000/v1/models \
-H "Authorization: Bearer <auth-key>"说明
| 字段 | 说明 |
|---|---|
| 返回模型 | 上游模型列表，并补充 gpt-5、gpt-5-1、gpt-5-2、gpt-5-3、gpt-5-3-mini、gpt-5-5、gpt-5-mini、gpt-image-2、codex-gpt-image-2、auto |
| 接入场景 | 可接入 Cherry Studio、New API 等上游或客户端 |
POST /v1/images/generations
OpenAI 兼容图片生成接口，用于文生图。
curl http://localhost:8000/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <auth-key>" \
-d '{
"model": "gpt-image-2",
"prompt": "一只漂浮在太空里的猫",
"n": 1,
"response_format": "b64_json"
}'字段说明
| 字段 | 说明 |
|---|---|
model |
图片模型，当前可用值以 /v1/models 返回结果为准，推荐使用 gpt-image-2 |
prompt |
图片生成提示词 |
n |
生成数量，当前后端限制为 1-4 |
response_format |
当前请求模型中包含该字段，默认值为 b64_json |
POST /v1/images/edits
OpenAI 兼容图片编辑接口，用于上传图片并生成编辑结果。
curl http://localhost:8000/v1/images/edits \
-H "Authorization: Bearer <auth-key>" \
-F "model=gpt-image-2" \
-F "prompt=把这张图改成赛博朋克夜景风格" \
-F "n=1" \
-F "image=@./input.png"字段说明
| 字段 | 说明 |
|---|---|
model |
图片模型， gpt-image-2 |
prompt |
图片编辑提示词 |
n |
生成数量，当前后端限制为 1-4 |
image |
需要编辑的图片文件，使用 multipart/form-data 上传 |
POST /v1/chat/completions
面向图片场景的 Chat Completions 兼容接口，不是完整通用聊天代理。
curl http://localhost:8000/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <auth-key>" \
-d '{
"model": "gpt-image-2",
"messages": [
{
"role": "user",
"content": "生成一张雨夜东京街头的赛博朋克猫"
}
],
"n": 1
}'字段说明
| 字段 | 说明 |
|---|---|
model |
图片模型，默认按图片生成场景处理 |
messages |
消息数组，需要是图片相关请求内容 |
n |
生成数量，按当前实现解析为图片数量 |
stream |
已实现，但仍在测试 |
POST /v1/responses
面向图片生成工具调用的 Responses API 兼容接口，不是完整通用 Responses API 代理。
curl http://localhost:8000/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <auth-key>" \
-d '{
"model": "gpt-5",
"input": "生成一张未来感城市天际线图片",
"tools": [
{
"type": "image_generation"
}
]
}'字段说明
| 字段 | 说明 |
|---|---|
model |
响应中会回显该模型字段，但图片生成当前仍走图片生成兼容逻辑 |
input |
输入内容，需要能解析出图片生成提示词 |
tools |
必须包含 image_generation 工具请求 |
stream |
已实现，但仍在测试 |
- 择默认提示词模板后，没法再次点击取消，添加一键清空模板按钮
- 每个用户也能单独管理自己的提示词
- 提示词分享和用户导入
- 兑换码批量导出
- 接入支付功能
学 AI , 上 L 站：LinuxDO
感谢佬友的 basketikun/chatgpt2api 项目在 ChatGPT 逆向整理、OpenAI 兼容接口封装和自托管部署思路上的探索与开源分享。颜AI 的项目方向与部分实现思路受其启发。
感谢佬友的贴一个让设计师也觉得脊背发凉的提示词
感谢佬友的 🍌Banana Prompt Quicker项目在提示词快捷工作流上的开源分享与启发。
感谢所有为本项目做出贡献的开发者：