Os AI agents precisam de manipular imagens como parte dos seus fluxos de trabalho. As API tradicionais requerem OAuth, chaves de API e configuração de subscrição — barreiras que quebram 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 numa única ida e volta HTTP, pagando por imagem na chain sem registo prévio.
Porquê 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 repetição x402 — cada nonce é usado exatamente uma vez
- Sem estado — o seu agent não precisa de gerir 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
O 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
Envie a sua imagem por POST — receba HTTP 402
Envie um PNG, JPEG ou WebP bruto como corpo do pedido. A API devolve HTTP 402 com detalhes de pagamento estruturados — montante, ativo, rede e URL do facilitador.
- 3
Assine e submeta 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 este pedido específico.
- 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 devolve a imagem com o fundo removido em PNG ou WebP.
Perguntas Frequentes
Que 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 repetição está integrada?
Sim. Cada pagamento x402 inclui um nonce que só pode ser usado uma vez. Reutilizar um cabeçalho de pagamento já usado devolve HTTP 402, prevenindo gastos duplos.
O que acontece se o processamento falhar após o pagamento?
A falha é registada com o endereço da sua carteira e hash da transação para revisão manual. Contacte o suporte com o hash da sua transação. Não há reembolso automático.
Como posso testar sem gastar USDC real?
Use a testnet Base Sepolia. Obtenha USDC de teste no faucet da Coinbase, aponte o seu cliente para o URL do facilitador de testnet e teste o seu fluxo de pagamento completo sem custos.
Existe limite de velocidade para agents?
Os pedidos de descoberta não pagos (a primeira sonda 402) têm limite de 30 por minuto por IP. Os pedidos pagos com um cabeçalho X-PAYMENT válido não têm limite de velocidade.
Compare também as suas opções
Estas páginas lado a lado são a forma mais rápida de perceber se a Clear Canvas se adapta ao seu fluxo de trabalho.
Pronto para Começar?
Sem registo necessário. As suas imagens ficam no seu dispositivo.