集成 · 用 Pikeway 登录
什么时候用「用 Pikeway 登录」
你的用户通过 OAuth 2.1 把自己的 Pikeway 账户连接到你的应用。你的应用代表他们调用 API,每次调用都从他们自己的余额扣费,并受他们自己设定的消费上限约束。
工作方式
- 你的应用把用户引导到 Pikeway 授权页。用户登录(或注册)后,会看到你的应用名称、它能做什么,以及授权后会跳回哪里。
- 用户为你的应用选择消费上限:$1、$5、$20、$100 或不限,然后点击「允许」。
- 你的应用用授权码换取 access token。这个 token 就是一把属于该用户的 Pikeway key(
pk-…),带着用户选的上限,可用于网关的所有端点。 - 在用户的 控制台 → Keys 里,这个连接显示为一把以你的应用命名的 key(
MCP · Your App)。用户可以随时吊销。
谁付费
用户,从他们自己的 Pikeway 余额按标价扣费。你的余额完全不受影响。
谁拥有用户
共享。用户是你的客户,同时也是 Pikeway 账户持有人:他们在 Pikeway 充值、查看用量、撤销授权。
适合的场景
- agent 应用和聊天产品:每个用户的用量难以预估,你不想先垫付费用。
- MCP 客户端和 IDE 集成。Claude.ai、ChatGPT 等远程 MCP 客户端连接
/mcp/agent时用的就是这个流程。 - 开发者工具、notebook 和开源项目,用户已经有 Pikeway 账户,或者愿意注册一个。
- 无法承担按次 API 成本的免费或低价产品。
优缺点
优点
- 零成本风险:滥用和重度使用花的是用户自己的钱,并受他们所选上限的约束。
- 不用自建计费:充值、收据和用量记录都由 Pikeway 为用户处理。
- 标准 OAuth 2.1,带 PKCE 和动态客户端注册,任何 OAuth 库都能用,也没有需要保护的 client secret。
- 用户保有控制权:能清楚看到哪些应用已连接,并能单独吊销某一个。
缺点
- 用户多一步:他们需要一个有余额的 Pikeway 账户,你的功能才能用。
- Pikeway 对用户可见:用户会看到 Pikeway 授权页和 Pikeway 的价格。
- 不能加价:无法在每次调用上叠加你自己的利润。如果需要收入,请单独为你的产品收费。
- 用户余额或上限用完、或撤销授权时,调用随时可能失败。你的应用需要妥善处理这些情况。
你的应用能做什么、不能做什么
授权页会向用户如实说明以下内容,你的产品文案也应保持一致:
- 可以:调用 Pikeway 上的任何 API 和 AI 模型,按次从用户余额扣费,不超过用户选的上限。
- 可以:看到用户的账户邮箱或钱包地址(通过
/v1/auth/whoami)以及可用余额。 - 不能:提现、修改账户设置,或管理用户自己的 API 和 key。
与其他方案对比
| 直连 | 用 Pikeway 登录 | 自建代理 | |
|---|---|---|---|
| 谁付钱给 Pikeway | 你,从你的余额扣 | 每个用户,从各自的余额扣 | 你;再按你自己的方式向用户收费 |
| 谁拥有用户关系 | 你。用户看不到 Pikeway | 共享。用户有 Pikeway 账户,并授权你的应用 | 你。用户看不到 Pikeway |
| 用户需要 Pikeway 账户 | 不需要 | 需要 | 不需要 |
| 自定价格 | 把成本打包进你的产品 | 不行:用户按 Pikeway 标价付费 | 可以:加价、点数、套餐 |
| 消费控制 | 按 key 限额、agent key、IP 白名单 | 用户授权时选上限;随时可吊销 | 你自己的规则,再加 key 限额兜底 |
| 你需要运行什么 | 无需额外组件:后端直接调用 | 一个 OAuth 客户端和 token 存储 | 一个由你运维的代理服务 |
| 跑通第一次调用 | 几分钟 | 约一小时 | 一天或更久 |
准备好了?继续阅读 接入步骤。