AI agents precisam manipular imagens como parte de seus fluxos de trabalho. APIs tradicionais exigem OAuth, chaves de API e configuração de assinatura — barreiras que impedem a operação autônoma. A x402 API do Clear Canvas elimina tudo isso: qualquer agent com uma carteira Base financiada pode remover fundos de imagens em uma única ida e volta HTTP, pagando por imagem na blockchain sem registro prévio.
Por Que Usar o Clear Canvas
- Sem chave de API ou conta — apenas uma carteira na Base mainnet (ou Sepolia para testes)
- Preço determinístico — sempre $0.05 USDC por imagem, sem taxas surpresa
- Proteção contra replay x402 — cada nonce é usado exatamente uma vez
- Sem estado — seu agent não precisa gerenciar sessões ou tokens de autenticação
- Qualquer linguagem — Python, TypeScript, Go, Rust ou qualquer uma que fale HTTP
- Testnet disponível — teste na Base Sepolia antes de gastar USDC real
Como Funciona
- 1
Financie uma carteira Base com USDC
Seu agent precisa de uma carteira EOA na Base mainnet com USDC suficiente para pagar as imagens. Use o SDK da Coinbase ou qualquer biblioteca de carteiras para criar e financiar uma.
- 2
Faça POST da sua imagem — receba HTTP 402
Envie um PNG, JPEG ou WebP bruto como corpo da requisição. A API retorna HTTP 402 com detalhes de pagamento estruturados — valor, ativo, rede e URL do facilitador.
- 3
Assine e envie o pagamento USDC
Use o SDK x402 da Coinbase para assinar uma transferência de $0.05 USDC e codificá-la como cabeçalho X-PAYMENT em base64. O pagamento está vinculado criptograficamente a esta requisição específica.
- 4
Reenvie com X-PAYMENT — receba imagem transparente
Reenvie o mesmo POST com o cabeçalho X-PAYMENT. Após verificação bem-sucedida do pagamento, a API retorna a imagem com o fundo removido em PNG ou WebP.
Perguntas Frequentes
Quais carteiras são suportadas?
Qualquer conta de propriedade externa (EOA) na Base mainnet. Carteiras de hardware, software ou chaves derivadas programaticamente — qualquer carteira que possa assinar uma transferência USDC funciona.
A proteção contra replay está integrada?
Sim. Cada pagamento x402 inclui um nonce que só pode ser usado uma vez. Reutilizar um cabeçalho de pagamento já usado retorna HTTP 402, prevenindo gastos duplos.
O que acontece se o processamento falhar após o pagamento?
A falha é registrada com o endereço da sua carteira e hash da transação para revisão manual. Entre em contato com o suporte com o hash da sua transação. Não há reembolso automático.
Como testar sem gastar USDC real?
Use a testnet Base Sepolia. Obtenha USDC de teste no faucet da Coinbase, aponte seu cliente para o URL do facilitador de testnet e teste seu fluxo de pagamento completo sem custo.
Existe limite de taxa para agents?
Requisições de descoberta não pagas (a primeira sonda 402) são limitadas a 30 por minuto por IP. Requisições pagas com um cabeçalho X-PAYMENT válido não têm limite de taxa.
Compare também as suas opções
Estas páginas lado a lado são a forma mais rápida de ver se o Clear Canvas se encaixa no seu fluxo de trabalho.
Pronto para Começar?
Sem cadastro necessário. Suas imagens ficam no seu dispositivo.