SuperAPI AI 工具集

x402

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:x402 是一个开放协议,激活 HTTP 402「Payment Required」状态码,让 AI 智能体与应用使用稳定币进行即时、免许可的小额支付。适用场景包括实现按次付费 API 端点、构建可自主付费的 AI 智能体、为内容或数据访问创建微支付流程,以及在没有传统支付基础设施的情况下接受稳定币付款。

主要能力:相比传统支付,文档称 x402 配置时间从数天至数周缩短到分钟级,结算在 Celo 上为亚秒级,费用约为 0.001 美元 gas,最低支付可达 0.001 美元,并原生支持 AI 智能体。支持 Celo 上的代币:USDC(0xcebA9300f2b948710d2653dD7B07f33A8B32118C,6 位小数)、USDT(0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e,6 位小数)、USDm(0x765DE816845861e75A25fCA122bb6898B8B1282a,18 位小数)。网络配置支持 Celo 主网(链 ID 42220,RPC https://forno.celo.org)与 Celo Sepolia 测试网(链 ID 11142220,RPC https://forno.celo-sepolia.celo-testnet.org)。

使用方式:安装依赖 npm install thirdweb。客户端 React 使用 useFetchWithPayment 钩子自动处理钱包连接、支付签名、余额不足界面与重试;非 React 应用使用 wrapFetchWithPayment。服务端可在 Next.js 或 Express 中通过 settlePayment 与 facilitator 接受支付,从 PAYMENT-SIGNATURE 或 X-PAYMENT 请求头读取支付数据,配置 payTo、network、price 与 facilitator。支付流程为:客户端请求资源、服务端返回 402 及支付详情、客户端签名支付、携带 X-PAYMENT 头重试、服务端验证并链上结算、返回内容与凭证。环境变量包括客户端 NEXT_PUBLIC_THIRDWEB_CLIENT_ID 与服务端 THIRDWEB_SECRET_KEY。文档还给出按实际 token 用量计费的 upto 方案,以及与 ERC-8004 信誉验证结合的先验证后支付示例。

限制:资料未提供协议自身的安全审计、法务合规、代币价格波动或支持范围之外的链与代币信息;具体费率、可用性与服务条款以官方文档为准。