白标商户接入完整教程
基于 TokenGP 基础设施构建属于你品牌的 AI 模型平台。本文档涵盖商户申请、品牌定制、定价策略、自定义域名与月度结算的端到端接入流程。
总览 · 5 步走通全流程
申请 → 审批 → 配置 → 定价 → 结算
提交申请
填写品牌名、子域 slug、联系邮箱，提交后等审批
通过审批
收到激活邮件，设置 admin 密码后进入商户后台
配置品牌
logo、主色、字体、布局、文案、品牌套装一键应用
设置定价
每个模型独立 markup 或一键批量加价
月度结算
按合作约定的比例分账，月度自动汇款给商户
① 提交白标申请 + 缴纳押金
申请提交后我们 1 个工作日内反馈；正式上线前需缴纳 ¥10,000 人民币押金（对公电汇 / 支付宝 / 微信）
必填信息
- 子域名：上线后你的网址是
<子域名>.tokengp.com，例如acme→acme.tokengp.com。小写字母、数字、连字符（接口字段名为 slug）。 - 品牌名（name）：客户看到的展示名。例如 "Acme AI" 或 "阿克梅智能"。
- 联系邮箱（contactEmail）：批准后发激活邮件。建议公司域邮箱。
- 申请说明（可选）：简单说一下业务和场景。
两种提交方式
方式 B · API 提交
嵌进自己的内部系统。
curl https://api.tokengp.com/api/v1/merchant/apply \
-H "Content-Type: application/json" \
-d '{
"slug": "acme",
"name": "Acme AI",
"contactEmail": "founder@acme.com",
"contactName": "Jane Founder",
"applyMessage": "我们是一家面向 SaaS 行业的 AI 工具公司，想用 TokenGP 白标。"
}'押金 · ¥10,000
通过审批后、正式上线前，需要缴纳一笔 ¥10,000 人民币 押金，支持对公银行电汇、支付宝或微信支付。押金用于覆盖商户对其客户的服务承诺与平台合规风险，不计入商户的可用余额，也不参与每月结算分账。
押金的几个关键事实
- ✅ 金额：默认 ¥10,000（金额视合作规模可议）
- ✅ 形式：对公银行电汇、支付宝、微信支付均可
- ✅ 登记：到账后由我方财务在系统中登记，并留存付款凭证号 / 汇款备注
- ✅ 退还：商户主动申请退出 / 终止合作时，结清最后一期结算后 30 个自然日内按原缴纳方式退回
- ⚠️ 不可使用：不计入你的可用余额、不能抵扣调用费用、不参与月度结算
- ⚠️ 不计息：押金期间不产生利息
缴纳与退还的状态机
/my-settlements 页面会单独展示押金状态，跟月度结算分开列。② 通过审批 + 设置密码
审批后立刻发激活邮件，7 天内点链接设密码
③ 商户后台 · 菜单一览
登录后看到的真实左侧导航，共 5 组 12 项
下面是真实的侧边栏截图（实时渲染、不是图片，会跟着你的品牌色变）。「总览」在最上，下面按 运营 / 财务 / 我的工作区 / 系统 4 个分组排列：
总览
顶部
/dashboard总览一进后台首页看到的总览。KPI 卡片（本月营收/上游成本/毛利/活跃客户）+ 收益趋势图 + 最近调用流水。
运营 — 客户与订单
/users用户你的客户列表。看每个客户的余额、调用量、注册时间、最近活跃。可搜索、可导出 CSV。
/orders订单所有充值订单按时间倒序，状态（待支付 / 已到账 / 失败 / 已过期）一目了然，支持导出 CSV。
财务
/finance财务实时财务面板。本月收入、上游成本、毛利、净利（扣除平台抽成）。按模型 / 按时间趋势切片。
/costs上游成本上游成本明细，按模型维度切分，看清每个模型花了多少钱。
/card-payments卡支付在线支付订单明细。能看到每笔订单的支付流水号和支付方式。
/my-settlements我的结算历史月度结算单。每条都有完整的计算过程与金额，已付款的会显示付款凭证号。
我的工作区 — 你的白标
/brand品牌品牌定制。logo、主色、字体、按钮、布局、首屏文案、邮件发件显示名、法律链接、品牌套装。每次修改自动保存，可回滚最近 10 个版本。
/pricing定价定价管理。每个模型的 TokenGP 批发价与你自己的零售价对照。支持一键批量加价、单个模型微调、一键重置。
/api-keysAPI 密钥管理密钥（sk-mgmt-… 开头）的管理。用它把商户后台的能力接进你自己的内部系统。
/domains域名自定义域名管理。添加 ai.acme.com → DNS 验证 → 我方运维配置并维护 HTTPS 证书。
系统 — 安全
/security安全账户本身的安全配置。改邮箱、改密码、绑定二步验证（Google Authenticator 等 TOTP 应用）、查看历史登录 IP 与归属地。
④ 深度详解 · 品牌定制 /brand
所有让你的白标看起来像你自己产品的设置
1️⃣ 主色（最重要的一个）
你设的主色会自动渗透到整站所有按钮、链接、强调色、Logo 主色、邮件按钮 — 一次设置全套换肤。7 个常用预设：
2️⃣ 布局风格
你的客户登录后看到的控制台结构。侧边栏布局适合功能多的产品，顶栏布局更简洁。
3️⃣ 字体
4️⃣ 按钮形状 + 样式
5️⃣ 实时预览编辑器
真实的 /brand 后台：左侧编辑、右侧同步预览。下方是带侧边栏的完整后台界面：
📸 自动版本快照 + 回滚
每次保存改动前，系统自动给当前配置拍快照。最多保存最近 10 版。一键回滚到任意版本。
⑤ 深度详解 · 定价 /pricing
你的零售价、上游成本与毛利分成
三层价格模型
每次客户调用 API，系统按这三步计算：
① 客户付：你设的零售价
例如你给某个模型设了 ¥36 / 1M input tokens，客户每次调用按这个扣。
② 平台付上游：模型上游成本
同样这次调用，TokenGP 付给模型厂商的上游成本假设是 ¥20 / 1M。各模型上游折扣不同，成本以结算单为准。
③ 毛利分成：你得 80%
毛利 = ¥36 − ¥20 = ¥16 / 1M。按合作协议约定比例分成（默认你得 80% 即 ¥12.8，平台 20% 即 ¥3.2）。按实际消费月结，充值未消费的部分不结算。
/pricing 页面真实界面
按厂商分 tab（通义千问 / DeepSeek / Kimi / 智谱 GLM 等）。每行对比 TokenGP 批发价 vs 你的零售价 vs 毛利率：
定价
| 模型 | 批发价 / 百万 | 零售价 / 百万 | 毛利 | |
|---|---|---|---|---|
| qwen-flash | ¥8 / ¥40 | ¥12 / ¥60 | +50% | 编辑 |
| qwen3.8-max | ¥22 / ¥108 | ¥33 / ¥162 | +50% | 编辑 |
| deepseek-v4-pro | ¥24 / ¥144 | ¥36 / ¥216 | +50% | 编辑 |
| deepseek-v4-flash | ¥1 / ¥2 | ¥1.50 / ¥3 | +50% | 编辑 |
3 种常见定价策略
保守型 · markup 30%
所有模型批发价 ×1.3。客户感觉价格亲民、爆发增长。适合冷启动。
标准型 · markup 50%
所有模型批发价 ×1.5。行业常见水平。利润和客户感知平衡好。
高端型 · markup 100%
加价翻倍。配套品牌 / 服务 / 客户成功，客单价高的 B2B 适合。
⑥ 客户推广
白标站点不参与平台推广分润
⑦ 客户怎么充值（你看到的视角）
客户在你的白标网站充值的全流程
客户访问你的站点 → 充值页 → 到账 → 你在财务看板看到这笔充值
下面 4 个状态自动循环演示，配色用你的品牌色：
为账户充值
关键时间线
- T+0：客户发起充值（在线充值或对公转账）
- 支付确认后：生成充值订单 → 客户余额实时增加 → 客户在自己的控制台看到
- 随后：客户开始消费，你的 /finance 看板实时更新
- 每月 1 号 08:30（北京时间）：上月结算单自动生成，可在「我的结算」查看
⑧ 深度详解 · 自定义域名 /domains
把客户访问的域名从 acme.tokengp.com 换成 ai.acme.com
为什么用自定义域名
- ✅ 客户看到的是你的品牌域名，不暴露 TokenGP
- ✅ 跟你自己的 SaaS 产品 URL 风格一致
- ✅ HTTPS 证书由我们签发并负责到期续期
- ✅ 不用也行：默认就有 acme.tokengp.com 兜底
5 步配置流程
- 确认该域名已完成 ICP 备案（备案到你方主体或接入到我方主体均可）—— 未备案的域名指向境内服务器会被运营商拦截
- 商户后台 /domains 添加域名
- 在你的域名 DNS 那里加一条 CNAME 指向我们
- 等 DNS 生效（最长 24h，通常 5-30 分钟）
- 商户后台点「验证」，我们做 DNS 解析比对
- 验证通过后由我方运维配置 HTTPS 证书并上线（1 个工作日内）
DNS 配置示例
# 在你的域名服务商那里加一条 DNS 记录：
类型 名字 值
CNAME ai portal.tokengp.com/domains 真实界面
三种状态：✓ Active / ⏳ Verifying / ✗ Failed：
自定义域名
⑨ 深度详解 · 月度结算
平台和商户怎么分钱、什么时候打款、怎么核对
公式（每月 1 号 cron 自动算）
消费收入 = 当月你的客户实际用现金消费掉的金额
（充值了还没花的不算；花赠送额度的部分不算收入）
上游成本 = 当月你的站点产生的模型调用成本合计（含赠送额度的消费）
毛利 = 消费收入 − 上游成本
# 平台按毛利的约定比例抽成（默认 20%，你分得 80%），以合作协议为准
平台分成 = max(0, 毛利 × 约定比例)
# 剩下的就是当期应付给你的金额
应付商户 = max(0, 毛利 − 平台分成)
# 毛利为负时（罕见），平台分成与应付均按 0 计，不向商户追收
# 金额单位均为人民币/my-settlements 真实列表界面
商户在自己后台看到的历史结算列表：
我的结算
| 账期 | 充值 | 上游成本 | 平台抽成 | 应付 | 状态 |
|---|---|---|---|---|---|
| 2026年5月 | ¥60,600 | ¥22,900 | ¥7,540 | ¥30,160 | ✓ 已付款 |
| 2026年4月 | ¥51,500 | ¥20,800 | ¥6,140 | ¥24,560 | ✓ 已付款 |
| 2026年3月 | ¥42,700 | ¥17,600 | ¥5,020 | ¥20,080 | ✓ 已付款 |
| 2026年2月 | ¥34,700 | ¥13,100 | ¥4,320 | ¥17,280 | ✓ 已付款 |
单条结算单展开看
点开一条 settlement 看到的详情卡片：
Acme AI · 2026年5月
三方角色 · 谁做什么
每月 1 号 08:30（北京时间）
系统自动生成上月结算单，状态为「待结算」。
月初对账 + 打款
我们运营核对结算单，按你指定的对公银行账户打款。
商户后台标 paid
打款后状态变 paid，你在 /my-settlements 看到完整记录。
⑩ 财务面板 /finance
实时看本月营收、上游成本、毛利、净利
和 Dashboard 不同，/finance 是商户的专属财务视图，所有数字按月份切片，按模型拆，可下载报表：
财务
📊 4 个核心指标
收入 / 上游成本 / 毛利 / 平台分成后净额，实时计算。
🏆 按模型排行
Top 5 模型按本月营收排序，方便看哪个模型最赚钱。
📥 可下载报表
客户列表与订单列表支持导出 CSV，可自行做报表或交给会计。
⑪ 商户管理 API
把白标商户后台的能力嵌进你自己的内部工具
登录商户后台 → /api-keys 创建一把 Management Token (sk-mgmt-<slug>-...)，就可以用 Bearer 方式调所有 /api/v1/merchant/* 接口。
# 批量调价：把所有模型零售价设为 TokenGP 批发价 × 1.5
curl -X POST https://api.tokengp.com/api/v1/merchant/models/pricing/bulk \
-H "Authorization: Bearer sk-mgmt-acme-XXXXXXXX..." \
-H "Content-Type: application/json" \
-d '{"markup": 1.5}'
# 看本月财务
curl https://api.tokengp.com/api/v1/merchant/finance/summary \
-H "Authorization: Bearer sk-mgmt-acme-XXXXXXXX..."
# 添加自定义域名
curl -X POST https://api.tokengp.com/api/v1/merchant/custom-domains \
-H "Authorization: Bearer sk-mgmt-acme-XXXXXXXX..." \
-H "Content-Type: application/json" \
-d '{"hostname": "ai.acme.com"}'商户常见问题
申请前 / 上线前最常问的几个
审批要多久？▾
人工审核，通常 1 个工作日内反馈。需要提供公司主体信息用于签署合作协议。
我的客户充值的钱进谁的账户？▾
由 TokenGP 作为平台方统一收款并开票，月度结算时与你结清。你无需自行搭建收款通道。
我能看到我客户的数据吗？▾
可以。商户后台的「客户」页能看到你工作区下全部客户的充值、调用与余额；看不到其他商户的客户。
商户的客户能不能也用 TokenGP 主站？▾
可以。同一个邮箱可以在你的站点和 TokenGP 主站各注册一个账户，余额与密钥相互独立。
客户怎么充值？▾
完全跟 TokenGP 主站一样的充值方式（支付宝 / 微信在线充值，也可联系客服对公转账）。但用你的品牌渲染。
平台抽成怎么算？▾
按合作协议约定的比例从月度毛利中扣除。具体比例在合作意向沟通阶段商定，与业务体量、合作方式相关。
想下线 / 撤出怎么办？▾
联系我们，结清最后一期结算并完成打款后停用你的工作区，数据保留 30 天后清理。
可以用自己的发件域发邮件吗？▾
目前邮件统一由平台邮件服务发送，发件人的**显示名**会用你的品牌名，发件地址仍是平台域名。独立发件域属定制需求，需要另行评估。