集成 · 自建代理

什么时候用自建代理

在你的用户和 Pikeway 之间运行一个轻量服务。它负责认证你的用户、套用你的价格和规则,再用你的 key 把通过的调用转发给 Pikeway。

工作方式

你的代理提供与 Pikeway 相同的 /v1/*(也可以加上 /gw/*)路由,所以 Pikeway CLI、Skill、SDK 和你自己的 agent 都能直接对接它。用户使用你的凭证认证。代理校验凭证、判断这次调用是否允许,用你的 Pikeway key 转发,并记录 Pikeway 返回的费用,以便向用户收费。

谁付费

你从自己的余额支付 Pikeway。你的用户按你定的规则付钱给你:加价、点数、套餐或免费额度。

谁拥有用户

完全是你。用户登录你的产品、看到你的价格,完全不需要知道 Pikeway 的存在。

适合的场景

以自己的定价、点数或订阅套餐转售 API 能力的 SaaS 产品。
需要按用户配额、审计日志或 Pikeway 无从得知的合规规则的平台。
只开放目录中精选部分的产品:只允许特定的提供方或端点,参数也可能是固定的。
要求所有出站 API 流量都经过自家网关的企业。

优缺点

优点

完全掌控定价和利润:按次、按 token、按席位收费,或者打包销售。
使用你自己的认证:会话、SSO、你现有的 API key。用户不需要 Pikeway 账户。
精确控制用户能访问哪些提供方和端点,还能注入或去掉参数。
精确对账:每个响应都带 X-Pikeway-Call-Id 和 X-Pikeway-Cost,能与你的 Pikeway 账本逐行对应。

缺点

工作量最大:你要在请求链路上构建、部署、监控和扩容一个服务。
成本和坏账风险由你承担:即使用户没付钱给你,你也已经付给了 Pikeway。
多一跳带来额外延迟,也多了一个可能出故障的环节。
你需要跟进自己开放的那部分 Pikeway API 的变化(新字段、流式、异步任务)。

与其他方案对比

	直连	用 Pikeway 登录	自建代理
谁付钱给 Pikeway	你,从你的余额扣	每个用户,从各自的余额扣	你;再按你自己的方式向用户收费
谁拥有用户关系	你。用户看不到 Pikeway	共享。用户有 Pikeway 账户,并授权你的应用	你。用户看不到 Pikeway
用户需要 Pikeway 账户	不需要	需要	不需要
自定价格	把成本打包进你的产品	不行:用户按 Pikeway 标价付费	可以:加价、点数、套餐
消费控制	按 key 限额、agent key、IP 白名单	用户授权时选上限;随时可吊销	你自己的规则,再加 key 限额兜底
你需要运行什么	无需额外组件:后端直接调用	一个 OAuth 客户端和 token 存储	一个由你运维的代理服务
跑通第一次调用	几分钟	约一小时	一天或更久

不需要自定价格?

直连提供同样的 key 控制,而且没有额外服务要运维。

不想承担成本风险?

「用 Pikeway 登录」让每个用户从自己的余额付费。

可以先从在你自己的一个端点背后使用直连开始,等需要自定价格或更大的白名单时再扩展成完整的代理。