TokenEmpire

NeonAPI Docs

New API 后台接入说明

说明 TokenEmpire 前台官网如何配合 QuantumNous/new-api 作为真实 API 网关与管理后台。

1. 为什么使用 New API

NeonAPI 前台负责官网、价格、文档和用户转化；New API 负责真实的 API 网关、用户额度、Token、模型分组、渠道转发和用量统计。

2. New API 负责什么

用户管理
Token 管理
渠道管理
模型管理
分组权限
额度扣费
用量日志
渠道重试
上游转发
管理员后台

3. 推荐部署结构

配置示例
用户客户端
Codex / Cursor / Claude Code / Chatbox
        ↓
https://api.tokenempire.club/v1
        ↓
Nginx / HTTPS
        ↓
New API
        ↓
PostgreSQL + Redis
        ↓
OpenAI / Claude / Gemini / DeepSeek / 自定义上游
配置示例
用户浏览器
        ↓
https://tokenempire.club
        ↓
Next.js 官网
        ↓
跳转 New API 后台登录 / 创建 Token

4. 部署 New API 的推荐方式

不要在当前 Next.js 项目里部署 New API。推荐单独使用 Docker Compose 部署 New API，准备 PostgreSQL 和 Redis，使用 Nginx 反代并绑定 HTTPS。

后台域名：panel.neonapi.example
API 域名：api.neonapi.example
官网域名：neonapi.example
New API 使用独立服务和数据库

5. 域名建议

域名用途
neonapi.example首页、价格页、文档页
api.neonapi.exampleNew API 对外 API Base URL
panel.neonapi.exampleNew API 管理后台 / 用户控制台
image.neonapi.example后续生图接口，可选

6. New API 后台需要配置什么

管理员账号
用户分组：test / normal / coder / vip
模型倍率
渠道列表
上游 API Key
用户额度
Token 权限
日志记录
失败重试
余额不足自动停止
高价模型权限

7. 用户使用流程

  1. 1. 用户在官网查看价格
  2. 2. 联系客服或注册账号
  3. 3. 进入 New API 后台
  4. 4. 创建 API Token
  5. 5. 复制 Base URL 和 API Key
  6. 6. 填入 Codex / Cursor / Claude Code
  7. 7. New API 自动按模型和 token 扣费
  8. 8. 用户在后台查看余额和用量

8. 重要安全说明

不要在前端保存上游 API Key
不要把上游 API Key 暴露给用户
用户只应该拿到 New API 生成的 Token
上游 API Key 只应配置在 New API 后台
高价模型不要默认开放
每个用户建议独立 Token
每个工具建议独立 Token
余额为 0 应自动停止
异常消耗应触发人工审核