New API 高级定制版 使用教程

它是什么、适合谁

New API 高级定制版是一个 AI API 网关：把多家大模型供应商的接口聚合成一套统一的 OpenAI 兼容 API，配上令牌管理、分组权限、用量统计和成本核算。简单说，无论你是团队管理员想给成员分发模型调用额度，还是个人想在一个后台里管理多个上游 Key，它都能胜任。这个版本是深度定制版（基于官方 v1.0.0-rc.36），面向中文用户做了大量运营侧改造：人民币计费、充值送额度、每日签到、订阅套餐、免费模型专区。线上体验：https://ai.88531.cn（注册送体验金，每日签到再领额度）。

快速开始

用 Docker Compose 一条命令起服务（官方默认编排，含 PostgreSQL + Redis）：

docker compose up -d

打开 http://localhost:3000，注册管理员账号登录后台。生产环境部署前务必：修改 compose 内所有默认密码（数据库、Redis）、设置 SQL_DSN、多机部署时设置 SESSION_SECRET。数据库也可用 MySQL 或 SQLite（按 compose 文件内注释切换）。

界面速览

首页：顶部促销横幅 + 模型广场入口，站点默认中文界面。

常用操作

1. 注册与签到：注册账号后，页面上的签到按钮（支持人机验证）每日可点一次，签到即领额度；匿名访客会被引导注册。
2. 看免费模型：模型广场顶部有「今日免费模型」横幅（列出当天全部免费模型名单与数量），或在「定价类型」筛选里选「免费」，一键筛出当前 0 价格的模型（绿色标签）。价格每日凌晨自动同步官方价格表，限免恢复收费会自动生效。
3. 充值：钱包页选金额档，每个档位显示「到账 ¥x」与「已省 ¥x」；当前充值优惠为充多少送多少（例如充 1 元到账 2 元额度，上不封顶），自定义金额也有到账预估，支付确认弹窗会再次列出到账金额。
4. 订阅套餐：访问 /subscribe 套餐页，可用支付宝购买、余额支付或免费领取套餐；购买后自动升级分组、按周期重置额度，到期自动降级。
5. 创建令牌调用 API：在后台令牌管理页创建令牌，把统一网关地址和令牌填进支持 OpenAI 格式的第三方客户端或自己的代码；额度、分组、用量统计都在后台实时可见。
6. 切换界面语言：站点默认中文（不跟随浏览器语言），需要时可在界面里手动切换（内置中/英/繁体/法/日/俄/越七种语言）。
7. 看新手文档：站内 /docs 有 12 节图文指南（快速开始、签到、充值、分组、密钥、价格、Playground、第三方客户端、API 示例、FAQ），带锚点导航，左侧目录可直接跳转。

常见问题

• 免费模型在哪看？ 模型广场「今日免费模型」横幅或「免费」定价筛选；免费模型为 0 价格，调用不扣额度。
• 充值为什么翻倍到账？ 定制版默认设置充值赠送 100%（充多少送多少），属于站点运营配置，到账明细在钱包页和支付确认弹窗都能看到。
• 价格和官方不一致？ 官方价格每日凌晨自动同步（含限免恢复、价格涨跌、缓存价调整），一般次日生效。
• 订阅套餐到期会怎样？ 到期自动降级回原分组，周期性额度重置按套餐设置执行。
• 语言怎么变中文了？ 定制版默认中文、不再自动跟随浏览器语言，可在界面手动切回其他语言。
• 部署后管理页打不开？ 先确认 3000 端口与数据库/Redis 连接串（SQL_DSN、REDIS_CONN_STRING）配置正确，多机部署检查 SESSION_SECRET 是否已改。

更新与版本

当前版本号：v1.0.0-rc.36-custom（见仓库 VERSION 文件）。近期定制更新：

• 2026-09-30 · 蓝·大·今天免费（RC45）：模型广场新增「免费」定价筛选（含实时计数）与绿色标签；广场顶部新增「今日免费模型」横幅（名单 + 数量徽章，一键查看全部免费模型）；i18n 七语种同步；部署镜像更新至 new-api-custom:rc45
• 2026-09-24 · 充值优惠（RC42）：后端统一赠送比例 payment_setting.amount_bonus，全部到账路径生效并附回归测试；钱包页优惠横幅、到账金额展示、支付确认弹窗到账行；文档页与关于页新增优惠说明

完整历史见仓库内 CHANGELOG.md 与 RELEASE_NOTES.md。