x402 es el protocolo de micropagos de 2026 construido sobre HTTP 402, que permite a los agentes de IA pagar cada llamada API con micropagos de moneda estable en lugar de suscripciones prepagas. Con más de 119 millones de transacciones a marzo de 2026, es el patrón de API paga de más rápido crecimiento. Este tutorial muestra cómo conectar x402 a sus llamadas API de Scavio para facturación basada en el uso.
Requisitos previos
- Python 3.8+ o Nodo 20+
- Una biblioteca cliente x402 (x402-python o x402-js)
- Una billetera x402 financiada (red base)
- Un punto final habilitado para Scavio x402
Guia paso a paso
Paso 1: Instalar el cliente x402
Instale el cliente x402 oficial.
Bash
pip install x402-pythonPaso 2: Configura tu billetera
Dirija al cliente a su billetera de red Base financiada.
Python
from x402 import Client
client = Client(
private_key=os.environ['X402_WALLET_KEY'],
network='base'
)Paso 3: Realizar una llamada habilitada para x402
Llame al punto final x402 de Scavio. El cliente maneja HTTP 402 y paga automáticamente.
Python
response = client.post(
'https://api.scavio.dev/x402/v1/search',
json={'query': 'AI agents 2026'}
)
print(response.json())Paso 4: Verificar recibo de pago
Cada respuesta incluye el recibo de pago x402 para auditoría.
Python
print('Paid:', response.headers.get('x-402-amount'))
print('Receipt:', response.headers.get('x-402-receipt'))Paso 5: Lote para la eficiencia
Consultas por lotes para reducir los gastos generales de pago por llamada.
Python
queries = ['query1', 'query2', 'query3']
responses = client.batch_post(
'https://api.scavio.dev/x402/v1/search',
[{'query': q} for q in queries]
)Ejemplo en Python
Python
import os
from x402 import Client
client = Client(private_key=os.environ['X402_WALLET_KEY'], network='base')
response = client.post(
'https://api.scavio.dev/x402/v1/search',
json={'query': 'AI agents 2026'}
)
print('Results:', len(response.json().get('organic_results', [])))
print('Paid:', response.headers.get('x-402-amount'), 'USDC')Ejemplo en JavaScript
JavaScript
import { Client } from 'x402-js';
const client = new Client({
privateKey: process.env.X402_WALLET_KEY,
network: 'base'
});
const response = await client.post('https://api.scavio.dev/x402/v1/search', {
query: 'AI agents 2026'
});
console.log('Results:', response.data.organic_results.length);
console.log('Paid:', response.headers['x-402-amount'], 'USDC');Salida esperada
JSON
Results: 10
Paid: 0.003 USDC
The agent paid 0.003 USDC per API call. No prepaid subscription, no minimum commitment.