tokencoup
版本: International · 国内版 语言: ZH · EN
获取 API Key

网关模式:A 与 B(完整版)

2026-11-13

网关模式 A 与 B,完整版

短版在欢迎帖里;这是长版。网关是千帆

前面的一个 OpenAI 兼容代理。模式 B(计量转售)已于 2026-11-13 取消;剩下的是

模式 A,以及 B 为什么必须走的故事——这本身就是本项目的合规教训。

模式 A——自带 key(BYOK)

你自己持有千帆 key,随请求发送;网关补上裸 key 没有的东西:网关鉴权

(X-Gateway-Key)、按订阅计划的限流、用量计量,以及跨千帆双版本的统一

OpenAI 兼容请求形状。

即用。

不可能因意外服务国际请求。

模式 B——计量转售(2026-11-13 已取消)

模式 B 的设计初衷是让客户不必各自成为千帆账号持有者:使用我们的国际版 key 池,

按 token 付费。现已撤销。原因不是技术性的:我们实际持有的 key 只有国内版,用

它们服务境外流量会违反本网关赖以存在的跨境数据规则(C2/S3)。一个无法合规经营

的合规特性不是特性,是一个带漂亮仪表盘的负债。

/intl/b 现在在两个版本的网关层一律被拒(403 mode_B_not_allowed_on_intl)。

为它实现的计量、计费、幂等与对账机制保留在代码库中——已测试、休眠——真实国际版

key 池出现时可以不重写就恢复。

为什么路径编码一切

/cn/a/... 不是文档糖。它让版本边界出现在每行日志、每张截图、每次事故复盘。

S3 拦截(国际路由不得用国内 key)由服务正常路径的同一份代码执行——没有开关可

配错,因为开关不存在。

边界在实践中如何体现

重写你的 body。

上线前诚实

https://api.tokencoup.com 目前边缘回 503 error.type=not_live;参考实现本地

运行,完整契约见 API 参考。模式 A 的 key 注册随账号系统

开放;在那之前,契约已文档化但未开售。我们发布诚实状态——包括尚未工作的部分,

以及我们选择完全不做的部分。

返回博客