AI agents 需要在工作流程中处理图片。传统 API 要求 OAuth、API 密钥及订阅设置——这些障碍会破坏自主操作。Clear Canvas x402 API 消除了这一切:任何拥有已充值 Base 钱包的 agent,都能在单次 HTTP 往返中去除图片背景,按图在链上支付,无需事先注册。
为什么选择 Clear Canvas
- 无需 API 密钥或账号——仅需 Base 主网钱包(或 Base Sepolia 用于测试)
- 确定性定价——每张图片固定 $0.05 USDC,不会有意外费用
- x402 防重放保护——每个 nonce 只能使用一次
- 无状态——您的 agent 无需管理 session 或认证 token
- 支持任何语言——Python、TypeScript、Go、Rust 或任何能发送 HTTP 请求的语言
- 提供测试网——在花费真实 USDC 前先在 Base Sepolia 测试
使用方法
- 1
为 Base 钱包充值 USDC
您的 agent 需要一个 Base 主网上拥有足够 USDC 的 EOA 钱包来支付图片费用。使用 Coinbase SDK 或任何钱包库来创建并充值。
- 2
POST 图片——收到 HTTP 402
以原始 PNG、JPEG 或 WebP 作为请求主体发送。API 返回 HTTP 402 并附带结构化付款信息——金额、资产、网络及 facilitator URL。
- 3
签署并提交 USDC 付款
使用 Coinbase x402 SDK 签署 $0.05 USDC 转账,并将其编码为 base64 的 X-PAYMENT 请求头。付款在密码学上与此特定请求绑定。
- 4
附带 X-PAYMENT 重新发送——收到透明图片
附带 X-PAYMENT 请求头重新发送相同的 POST 请求。成功验证付款后,API 以 PNG 或 WebP 格式返回已去除背景的图片。
常见问题
支持哪些钱包?
Base 主网上的任何外部拥有账户(EOA)。硬件钱包、软件钱包或程序化派生密钥——任何能签署 USDC 转账的钱包均可使用。
是否内置防重放保护?
是。每笔 x402 付款包含一个只能使用一次的 nonce。重放已使用的付款请求头将返回 HTTP 402,防止双重支付。
付款后若处理失败怎么办?
失败情况会连同您的钱包地址和交易哈希值一起记录,供人工审查。请附上您的交易哈希值联系客服。不提供自动退款。
如何在不花费真实 USDC 的情况下测试?
使用 Base Sepolia 测试网。从 Coinbase 水龙头获取测试网 USDC,将您的客户端指向测试网 facilitator URL,免费测试完整的付款流程。
Agents 有速率限制吗?
未付款的探测请求(第一次 402 探测)每个 IP 每分钟限制 30 次。携带有效 X-PAYMENT 请求头的付费请求没有速率限制。
也比较一下其他选择
这些并排比较页面能让您最快看出 Clear Canvas 是否适合您的工作流。
准备好开始了吗?
无需注册。您的图片始终留在您的设备上。