集成 · 直连
什么时候用直连
你的后端用你自己的 key 调用 Pikeway。每次调用都从你的余额扣费,用户只和你的产品打交道。
工作方式
你在控制台创建一把或多把 key,保存在你的服务器上。你的代码从服务端调用 /v1/run(或 /gw/<slug>/…)。Pikeway 看不到你的终端用户;在 Pikeway 看来,所有调用都来自你的账户。
谁付费
你。调用按标价从你的预付余额扣费。怎样收回成本(订阅、按量收费或免费)由你决定。
谁拥有用户
你。用户不需要 Pikeway 账户,也看不到 Pikeway,除非你主动告诉他们。
适合的场景
- 你自己的 agent 和自动化:调研机器人、交易信号、数据管道、CI 任务。
- 产品里的某个后端功能,比如补全用户资料、获取代币价格,API 只是实现细节。
- 原型和黑客松:一把 key、一个环境变量,几分钟跑通第一次调用。
- 同时运行很多 agent、希望每个都有独立预算,但不想自己做计费系统的团队。
优缺点
优点
- 工作量最小:不需要 OAuth、不需要代理,也没有额外服务要运维。
- 对用户透明:没有额外的注册或授权页面。
- 每把 key 都能精细设防:消费上限、IP 白名单,以及控制台 → Team 下有预算上限的 agent key。
- 公司运行的所有东西共用一个余额、一条账单记录。
缺点
- 每次调用的费用都由你承担,包括你自己的用户滥用产生的费用。你需要自己按用户做限流或配额。
- key 必须留在服务器上。浏览器或移动端要用的话,需要另建一把限定在你站点上的浏览器 key。
- Pikeway 里看不到按用户的归属:所有调用都属于你的账户。如果需要区分,给每个租户一把 key,或者改用 自建代理。
与其他方案对比
| 直连 | 用 Pikeway 登录 | 自建代理 | |
|---|---|---|---|
| 谁付钱给 Pikeway | 你,从你的余额扣 | 每个用户,从各自的余额扣 | 你;再按你自己的方式向用户收费 |
| 谁拥有用户关系 | 你。用户看不到 Pikeway | 共享。用户有 Pikeway 账户,并授权你的应用 | 你。用户看不到 Pikeway |
| 用户需要 Pikeway 账户 | 不需要 | 需要 | 不需要 |
| 自定价格 | 把成本打包进你的产品 | 不行:用户按 Pikeway 标价付费 | 可以:加价、点数、套餐 |
| 消费控制 | 按 key 限额、agent key、IP 白名单 | 用户授权时选上限;随时可吊销 | 你自己的规则,再加 key 限额兜底 |
| 你需要运行什么 | 无需额外组件:后端直接调用 | 一个 OAuth 客户端和 token 存储 | 一个由你运维的代理服务 |
| 跑通第一次调用 | 几分钟 | 约一小时 | 一天或更久 |
如果「用户」就是你自己,比如把你自己的 Claude、Cursor 或 Codex 连上 Pikeway,也应该用直连。见 MCP 快速开始。