网关模式:A 与 B(完整版)
2026-11-13
网关模式 A 与 B,完整版
短版在欢迎帖里;这是长版。网关是千帆
前面的一个 OpenAI 兼容代理。模式 B(计量转售)已于 2026-11-13 取消;剩下的是
模式 A,以及 B 为什么必须走的故事——这本身就是本项目的合规教训。
模式 A——自带 key(BYOK)
你自己持有千帆 key,随请求发送;网关补上裸 key 没有的东西:网关鉴权
(X-Gateway-Key)、按订阅计划的限流、用量计量,以及跨千帆双版本的统一
OpenAI 兼容请求形状。
- key 不在我方存储;以
Authorization: Bearer(或X-Provider-Key)转发一次
即用。
- key 版本校验 fail-closed:只有登记在注册表的 key 才可用于对应版本,国内 key
不可能因意外服务国际请求。
- 定价是固定订阅;对你的 key 没有 per-token 加成。
模式 B——计量转售(2026-11-13 已取消)
模式 B 的设计初衷是让客户不必各自成为千帆账号持有者:使用我们的国际版 key 池,
按 token 付费。现已撤销。原因不是技术性的:我们实际持有的 key 只有国内版,用
它们服务境外流量会违反本网关赖以存在的跨境数据规则(C2/S3)。一个无法合规经营
的合规特性不是特性,是一个带漂亮仪表盘的负债。
/intl/b 现在在两个版本的网关层一律被拒(403 mode_B_not_allowed_on_intl)。
为它实现的计量、计费、幂等与对账机制保留在代码库中——已测试、休眠——真实国际版
key 池出现时可以不重写就恢复。
为什么路径编码一切
/cn/a/... 不是文档糖。它让版本边界出现在每行日志、每张截图、每次事故复盘。
S3 拦截(国际路由不得用国内 key)由服务正常路径的同一份代码执行——没有开关可
配错,因为开关不存在。
边界在实践中如何体现
- 请求:路径决定版本和模式;header 携带 key,不携带策略。
- 响应:仅在降级时加
X-Tokencoup-Status;正常 200 就是上游形状,因为我们不
重写你的 body。
- 计费:模式 A 订阅计费与休眠的模式 B 机制永不共享台账范围。
上线前诚实
https://api.tokencoup.com 目前边缘回 503 error.type=not_live;参考实现本地
运行,完整契约见 API 参考。模式 A 的 key 注册随账号系统
开放;在那之前,契约已文档化但未开售。我们发布诚实状态——包括尚未工作的部分,
以及我们选择完全不做的部分。