集成
把 Pikeway 集成到你的产品
让你的用户或你自己的 agent 用上整个 Pikeway 目录。有三种接入方式,区别在于谁付费、谁拥有用户关系,以及你需要自己运行多少东西。
三种方式调用的是同一个网关,用的都是 Pikeway key(pk-…),所以发现 API、按次计价、「只为成功的调用付费」这些规则都一样。区别在于 key 属于谁,以及你的用户和 Pikeway 之间隔着什么。
选择接入方式
直连
你的服务器,你的 key。用户看不到 Pikeway;每次调用由你付费。
用 Pikeway 登录
用户通过 OAuth 2.1 连接自己的 Pikeway 账户,从自己的余额付费。
自建代理
在 Pikeway 前面加上你自己的认证、计费和白名单,再转发通过的调用。
快速决策
- 在做内部 agent、后端功能或原型,并且愿意自己承担费用?用 直连。
- 在做 agent 应用、MCP 客户端或开发者工具,希望每个用户为自己的用量付费?用 用 Pikeway 登录。
- 在自己的 SaaS 里转售 API 能力,需要自己的价格、套餐或点数,以及精选的端点范围?用 自建代理。
方案对比
| 直连 | 用 Pikeway 登录 | 自建代理 | |
|---|---|---|---|
| 谁付钱给 Pikeway | 你,从你的余额扣 | 每个用户,从各自的余额扣 | 你;再按你自己的方式向用户收费 |
| 谁拥有用户关系 | 你。用户看不到 Pikeway | 共享。用户有 Pikeway 账户,并授权你的应用 | 你。用户看不到 Pikeway |
| 用户需要 Pikeway 账户 | 不需要 | 需要 | 不需要 |
| 自定价格 | 把成本打包进你的产品 | 不行:用户按 Pikeway 标价付费 | 可以:加价、点数、套餐 |
| 消费控制 | 按 key 限额、agent key、IP 白名单 | 用户授权时选上限;随时可吊销 | 你自己的规则,再加 key 限额兜底 |
| 你需要运行什么 | 无需额外组件:后端直接调用 | 一个 OAuth 客户端和 token 存储 | 一个由你运维的代理服务 |
| 跑通第一次调用 | 几分钟 | 约一小时 | 一天或更久 |
这几种方式可以组合使用。常见做法是:自己的后台任务用直连,愿意花自己余额的重度用户走「用 Pikeway 登录」。自建代理也可以在上游给每个租户分配一把有预算上限的 key。
不变的部分
- 同样的端点:Agent API(
/v1/discover、/v1/inspect、/v1/run)、原始网关(/gw/<slug>/…)、AI 网关和 MCP。 - 同样的计费:每次调用固定价格,只有上游返回 2xx 才扣费,每个响应都带
X-Pikeway-Cost和X-Pikeway-Call-Id。 - 同样的 key 控制:消费上限、IP 白名单和站点限制。见 Key、余额与计费。
想上架你自己的 API?
这几页讲的是如何 使用 目录里的 API。如果你想把自己的 API 放进目录,让 agent 发现并付费调用,请阅读 服务商指南。服务商可获得每次调用 90% 的收入。