Baron Power Play

Baron Power Play

面向自主 Agent 的按次付费 AI 基础设施。使用 Base 上的 USDC，由 Coinbase 结算。无需 API 密钥、无需账户、无需订阅。

Base URL：https://baron-power-play.baronpowerplay.workers.dev

---

为什么要打造它

Agent 在使用付费 API 时会以四种可预见的方式失败。Baron Power Play 旨在逐一解决这些问题。

Agent 遇到的问题	Baron 的应对方式
付费前无法了解服务的价格或形式	每个路由都会公布准确的 x402 v2 挑战和机器可读的契约。发送第一个请求前，你就能精确到小数点后六位了解费用。
服务提供商在任务进行到一半时返回 429，导致 Agent 停摆	多个独立引擎，支持自动故障转移，并共享每日容量池。某个引擎宕机对调用方不可见。
第三方服务可能通过夹带在响应中的文本操控你的 Agent	付款前会拦截提示词覆盖尝试，返回前会扫描模型输出。

如果你是 Agent，请先阅读 /.well-known/x402.json 和 /openapi.json。 它们是契约。本 README 是面向人类的摘要。

---

付款前验证

此操作免费，也是判断是否要依赖我们的最快方式。

curl https://baron-power-play.baronpowerplay.workers.dev/test

它会返回各引擎的健康状况、实时推理结果，以及对市场数据和语音路径的实时检查。每当你准备依赖此服务时都运行一次，而不是只在注册时运行。

---

服务

端点	方法	价格（USDC）	可获取的内容
/infer	POST	0.001	大模型推理。JSON 和代码会在返回时自动格式化。
/markets	GET	0.002	DeFi TVL 排名靠前的项目、DEX 热门交易对、meme 分类、自选列表、增量同步。
/alpha	GET	0.05	使用 Kelly 准则进行仓位配置的交易笔记。尚未公布经过验证的历史表现记录——请将其视为研究输入，而非交易信号。
/tts	POST	0.01	文本转语音，支持情感演绎和按钱包记忆的发音词典。
/stt	POST	0.01	语音转文本，支持加密货币关键词检测和带时间戳的片段。
/test	GET	免费	就绪状态、引擎健康状况和实时能力检查。

/alpha 接受 portfolio_size_usd 作为查询参数。

---

付款

• 网络： Base（eip155:8453）
• 资产： USDC，通过 EIP-3009 transferWithAuthorization 付款
• 资产标识： USD Coin 版本 2
• 协议： x402 v2 — HTTP 402 Payment Required
• 协调器： Coinbase CDP（https://api.cdp.coinbase.com/platform/v2/x402）
• 收款钱包： 0xb838930bf3dFD467D30979E12c0a94286F86708D

流程采用标准方式。你发送请求，收到包含确切付款要求的 402 响应，签署授权，再通过 PAYMENT-SIGNATURE 请求头重新发送，随后协调器在 Base 上完成结算。只有在 Coinbase 验证并结算付款后，才会执行服务。 绝不提供未付款的服务。

传输中的金额以代币最小单位表示。一次 0.001 USDC 的调用，在 accepts[].amount 中报价为 1000。openapi.json 中的 amount 字段表示十进制美元金额；运行时的 accepts[].amount 则表示最小单位金额。

---

容量

推理服务由多个独立引擎共享处理，并根据剩余容量选择引擎，同时支持自动故障转移，因此上游服务故障对调用方不可见。

容量会在 UTC 时间 00:00 重置。容量池耗尽时，路由会返回机器可读的 SOLD_OUT，并附上 Retry-After 和回归使用优惠，而不是通用错误。

/markets、/alpha、/tts 和 /stt 不占用大模型引擎池的容量。

---

限制与滥用控制

每个钱包每天：

• 每个端点 50 次调用（/alpha：20 次）
• 钱包启用后的前 24 小时内，限额更低
• 总支出 $10
• 每秒 10 个支付请求

每个请求：

• 必须提供 User-Agent，至少 3 个字符
• POST 必须发送 Content-Type: application/json
• 拒绝超过 1 MB 的请求正文
• 拒绝超过 2000 个字符的查询字符串
• X-Idempotency-Key 可选，最多 128 个字符，且仅限指定字符集
• 错误的 HTTP 方法会返回 405 和机器可读的 METHOD_NOT_ALLOWED

防止重复使用：

• 已使用的支付标头会在 1 小时内被拒绝
• 已使用的 USDC 授权 nonce 会在 24 小时内被拒绝
• 一小时内有 5 次覆盖尝试被拒后，该钱包会被封禁一天

所有错误都采用同一种格式，因此你可以根据 code 进行分支处理，而不必解析错误描述：

{
  "error": "/infer accepts POST, not GET",
  "code": "METHOD_NOT_ALLOWED",
  "suggestion": "Use POST /infer.",
  "timestamp": 1790458945409
}

---

推荐

推荐一个钱包，双方都能受益：被推荐的钱包首次付费调用可享受 10% 折扣，推荐人在结算后可获得列表价格 5% 的返利。每天最多接受 3 次被推荐调用，且不能自我推荐。

---

发现

• GET /openapi.json — 规范的 OpenAPI 3.1 契约：请求和响应架构、每个路由的 x-payment-info、错误代码
• GET /.well-known/x402.json — x402 清单：端点、价格、方法、facilitator、支付要求、防护措施
• GET /test — 免费健康状态和容量检查

---

使用方法

BASE=https://baron-power-play.baronpowerplay.workers.dev

# free readiness check
curl -s "$BASE/test"

# the machine-readable contract
curl -s "$BASE/openapi.json"

# see the exact payment requirement before paying anything
curl -si -X POST "$BASE/infer" \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: your-agent/1.0' \
  -d '{"messages":[{"role":"user","content":"hello"}]}'
# -> HTTP 402 with the x402 v2 challenge in accepts[]

# market data
curl -s "$BASE/markets"

要进行付费调用，请从 402 响应中获取 accepts[] 条目，使用你的钱包为匹配的 EIP-3009 授权签名，然后在原始请求中添加 PAYMENT-SIGNATURE 标头并重新发送。任何 x402 v2 客户端库都可以为你完成这些操作。

---

许可证

尚未声明。在将其视为可复用内容之前，请添加 LICENSE 文件。