Skip to main content
超级 API 让智能体可以发现服务、获得报价、授权付款并取得 API 响应。

浏览超级 API

在 Agents 视图中打开超级 API，然后复制已经准备好的提示词或端点示例。

​
调用前先查找服务

列出当前服务：
然后读取所选服务的最新端点信息：
请把目录条目的 id 作为 upstream_id，再使用服务信息响应中 endpoints 和 curl_x402 给出的 HTTP 方法、参数与 x402 URL；不要根据展示名称自行拼接。

​
进行付费调用

配置智能体钱包密钥后：
POST 端点示例：
该命令会：
  1. 发起初次请求；
  2. 解码支付要求；
  3. 显示报价；
  4. 请求确认；
  5. 使用所选智能体钱包签名；
  6. 带支付签名重试；
  7. 输出 API 结果。
使用 --format json 获得机器可读输出。只有明确允许运行环境自动批准报价时才使用 --yes。

​
支付安全规则

  • 符合条件时，先使用组织额度，再使用钱包 USDC。
  • 智能体钱包的支出策略在服务端执行。
  • 超出策略上限的付款会被拒绝。
  • 应定期刷新目录和服务信息响应，不要永久缓存。