给 API 提供者

提供者指南

上架一次,Pikeway 上所有 agent 都能找到它、调用它、为它付费,每次成功调用你都有收入。

五步上架一个 API

  1. 1
    创建草稿

    在控制台「我的 API」里填名称和分类创建空白 API,或导入 OpenAPI 文件 / Postman 集合自动生成端点。

  2. 2
    连接你的上游

    设置源站地址,以及 Pikeway 调用它时的鉴权方式(请求头、query 或签名)。凭据加密存储,买家永远看不到。

  3. 3
    给每个端点定价

    每个端点一个固定的按次价格。只有上游成功响应(HTTP 2xx)才向买家收费,失败的调用免费。

  4. 4
    写给 agent 的说明(可选)

    每个 API 都会根据端点自动生成 SKILL.md。在「Skill」标签里补充 agent 应该知道的:什么时候用哪个端点、限制、推荐参数。

  5. 5
    声明来源并提交审核

    说明这是你自己的 API、可转售的官方 API,还是获得授权的转售,同意卖家条款后提交审核,通过即上线。

怎么收钱

  • 每次成功调用你拿 90%,Pikeway 收 10%。
  • 收入先冻结 14 天(买家可在此期间对错误扣费发起争议),之后转为可提现。
  • 在控制台「收益」里把可提现收入以 USDC 提走,或转入余额用来调用其他 API。
  • 每一笔收入都记在账本里,能追溯到对应的调用。

上线之后

  • 「数据分析」「调用方」「告警」里能看到流量、延迟、错误,以及谁调用你最多(调用方匿名显示)。
  • 修改以新修订版发布:审核期间线上版本照常服务。
  • 如果上游持续拒绝你的凭据(401/403)且核验调用也失败,API 会被自动暂停并通知你;修好 key 后即可恢复。
  • 买家可以评价和举报,举报由 Pikeway 审核。

可以上架什么

  • 你自己的 API、条款允许服务你的客户的官方 API,或你有书面转售授权的 API。
  • 禁止:转售消费级 AI 订阅(ChatGPT Plus、Claude Pro、Cursor、Copilot 等),或用登录 / OAuth / 会话令牌作为上游凭据。
  • 描述不实或违规的上架会被下架,相关收入可能被扣留。

服务商:验证流量来自 Pikeway

Pikeway 发往你源站的每个请求都带有 X-Pikeway-Proxy-Secret。在「我的 API → 设置」里找到它的值,拒绝不带它的请求,别人就绕不过网关。

完整规则: 卖家条款 · 使用规范