Token API 中转+商城系统+支付集成技术方案

Token API 中转+商城系统+支付集成技术方案

Token API 中转演示:https://token.macosabc.com
Token API 中转+商城系统集成演示:https://macosabc.com

Dujiao-Next:



New-api:https://www.newapi.ai/zh

epay:https://github.com/cnmbdb/epay/releases/download/2026.5.25/usdt.zip


项目完整说明:从 Token API 到商城支付闭环

本项目对应 IDE/token-api,定位并不是单独的一套模型服务,而是整个 AI API 商业化方案的统一入口。当前仓库采用纯 HTML、CSS 与 JavaScript 构建产品展示页,不依赖前端框架或构建工具;API 中转控制台、商品销售系统和支付系统分别独立部署,再通过域名、链接和业务接口组合成一套完整服务。

这种拆分方式的好处是边界清晰:展示页面负责品牌、产品介绍和用户引导;Token API 控制台负责模型聚合、密钥、额度、路由和调用记录;Dujiao-Next 负责商品、订单与用户购买流程;epay 负责 USDT 等支付渠道。任何一个模块升级时,都不必重写其他模块。

一、系统由哪些部分组成

  1. 产品展示入口:macosabc.com。用于展示平台能力、接入流程、计费方案、常见问题和控制台入口。
  2. Token API 控制台:token.macosabc.com。向用户提供统一的 API Base URL、密钥管理、模型列表、额度账单和使用统计。
  3. API 网关与模型通道:通过 New API 类网关统一管理不同上游模型渠道,对外提供兼容 OpenAI SDK 的调用格式。
  4. 商城与订单:Dujiao-Next 用于销售额度、套餐、兑换码或其他数字商品,并承担订单查询和交付流程。
  5. 支付层:epay 用于连接 USDT 等支付方式。支付成功后,由商城或业务服务完成订单确认与交付。

二、项目解决的核心问题

当业务同时接入 OpenAI、Claude、Gemini、DeepSeek 等模型时,如果每个供应商分别维护请求地址、密钥格式、余额和错误处理,应用代码会越来越复杂。Token API 中转层把这些差异收束到一个入口:客户端只需要保存一个 Base URL 和一枚平台密钥,即可根据平台开放的模型列表发起调用。

  • 统一 API 地址与 OpenAI 兼容请求格式,降低客户端迁移成本。
  • 按用户、项目或环境拆分密钥,便于权限隔离和额度控制。
  • 统一查看请求次数、Token 消耗、余额、错误记录和模型使用占比。
  • 根据价格、速度、稳定性或模型能力配置不同通道和路由策略。
  • 将 API 服务与商城订单连接,让套餐购买、支付确认和额度交付形成闭环。

三、一次完整的用户使用流程

  1. 用户从产品展示页进入商城或 Token API 控制台。
  2. 在商城选择对应的额度、套餐或兑换商品并创建订单。
  3. 通过 epay 完成支付,支付服务向商城回传订单结果。
  4. 商城校验订单号、金额、支付状态和回调签名,确认订单只能交付一次。
  5. 系统按实际业务规则发放兑换码、账户余额或 API 使用额度。
  6. 用户在控制台创建 API Key,选择可用模型并复制 Base URL。
  7. 客户端发起请求,之后可在控制台持续查看用量、费用和错误日志。

这里需要注意:自动充值、自动发放密钥或兑换码属于商城与 Token API 之间的业务集成能力,应通过服务端接口实现,不能在静态展示页中保存商城密钥、支付密钥或管理员令牌。

四、API 接入示例

平台对外入口为 https://token.macosabc.com/v1。如果现有项目已经使用 OpenAI SDK,通常只需要修改 Base URL、API Key 和模型名称,无需重写业务层。

curl https://token.macosabc.com/v1/chat/completions \
  -H "Authorization: Bearer $MACOSABC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请填写控制台中实际可用的模型名称",
    "messages": [
      {"role": "user", "content": "你好,请介绍一下你自己"}
    ]
  }'

Python 项目可以直接使用 OpenAI 兼容客户端:

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://token.macosabc.com/v1",
)

response = client.chat.completions.create(
    model="控制台中的实际模型名称",
    messages=[
        {"role": "user", "content": "测试 Token API 接入"}
    ],
)

print(response.choices[0].message.content)

模型名称、计费倍率和可用能力以控制台实时展示为准。正式上线前,应分别验证普通响应、流式响应、超时、余额不足、模型不存在和上游故障等场景。

五、token-api 展示项目的技术特点

  • 零构建依赖:项目核心只有单页 index.html,下载后即可直接预览和部署。
  • 响应式布局:桌面端展示完整控制台视觉,移动端提供折叠导航和适配后的信息布局。
  • 产品化内容:页面覆盖平台优势、模型入口、接入步骤、价格方案、常见问题和行动入口。
  • 控制台预览:通过界面模拟密钥管理、模型路由、用量统计、余额账单和请求趋势,让用户在注册前理解产品结构。
  • 独立域名:仓库包含 CNAME 配置,可部署到静态托管平台,也可以直接交由 Nginx、对象存储或 CDN 托管。

六、推荐部署结构

用户浏览器
  ├─ macosabc.com             产品展示与商城入口
  ├─ token.macosabc.com       Token API 控制台与 /v1 接口
  └─ 支付渠道                 epay / USDT

服务端
  ├─ 静态站点或 CDN           托管 token-api 展示页
  ├─ New API 网关             模型、通道、密钥、额度、日志
  ├─ Dujiao-Next              商品、订单、用户与交付
  ├─ epay                     支付订单与异步回调
  └─ 数据库与缓存             保存业务数据和运行状态

建议把展示站、API 网关、商城和支付服务部署为独立服务,并分别配置健康检查、日志保留和备份策略。域名统一接入 HTTPS,外部只开放必要端口;数据库、缓存和内部管理接口不要直接暴露到公网。

七、支付与自动交付的安全重点

  • 支付回调必须校验签名,不能只根据前端跳转结果修改订单状态。
  • 同时校验商户订单号、支付金额、币种和实际到账状态。
  • 使用唯一订单号和幂等锁,避免重复回调导致重复充值或重复发货。
  • 商城调用 Token API 管理接口时使用独立的服务端密钥,并限制来源地址和权限范围。
  • API Key、支付密钥、数据库密码只能放在服务端环境变量中,禁止写入 index.html 或公开仓库。
  • 对登录、创建密钥、支付回调和 API 请求设置速率限制与异常告警。
  • 定期备份订单、用户余额、兑换记录和网关配置,并实际演练恢复流程。

八、上线前检查清单

  • 展示页、商城、控制台和 API 地址均能通过 HTTPS 正常访问。
  • 新用户可以完成注册、登录、购买、支付、交付和创建密钥。
  • 测试订单不会被重复交付,失败订单不会错误增加余额。
  • 至少验证一个普通对话模型和一个流式响应模型。
  • 余额扣减、倍率、Token 统计和商城售价之间保持一致。
  • 上游接口超时或不可用时,平台能返回明确错误并记录日志。
  • 管理员可以查询订单、支付回调、额度变化和 API 调用记录。
  • 完成数据库备份、配置备份、监控告警和故障恢复测试。

九、适合哪些使用场景

这套方案适合 AI 工具、聊天机器人、内容生成平台、企业内部 AI 助手、开发者 API 服务以及需要向用户销售模型额度的项目。它既可以作为公开商业服务,也可以裁剪为团队内部的统一模型网关。

如果只需要内部调用,可以保留 Token API 网关并关闭商城;如果需要对外销售,则可以继续完善用户体系、商品套餐、支付回调、自动交付、退款处理和财务对账。模块化结构允许项目按真实业务量逐步扩展,而不必在初期一次性建设所有功能。

十、相关地址

总结:Token API 项目的核心价值,是把“模型供应商接入、统一 API、用户密钥、额度计费、商城订单和支付交付”组织成清晰的业务链路。展示页负责建立产品认知,网关负责稳定调用,商城负责交易,支付系统负责资金确认。四个部分相互独立又能够组合,适合从小规模验证逐步扩展到正式运营。

THE END
喜欢就支持一下吧
点赞6 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容