API x402 para modelos de IA: paga por solicitud en USDC
RunAPI acepta pagos x402 en sus endpoints por llamada. Un agente envía una solicitud normal, recibe una cotización 402, la firma con su wallet y obtiene el resultado. Sin cuenta, sin API key, sin créditos prepagados.
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 recursos que se pueden pagar con x402
- Base red de liquidación
- USDC activo de pago
- 0 API keys requeridas
Cuatro pasos, de la solicitud al resultado
-
Envía la solicitud sin una key
Haz un POST con el mismo cuerpo JSON que enviarías con una API key, pero sin el encabezado Authorization.
-
Lee la cotización 402
RunAPI responde 402 con un encabezado PAYMENT-REQUIRED que indica el monto exacto, el activo, la red y el destinatario. La cotización es válida durante 300 segundos.
-
Firma y reintenta
Tu cliente x402 v2 firma una autorización EIP-3009 con la wallet del agente y reenvía la solicitud con un encabezado PAYMENT-SIGNATURE.
-
Consulta la tarea
RunAPI liquida el pago, inicia la tarea y devuelve 200 con un recibo PAYMENT-RESPONSE y un poll_url para el resultado.
Lo que debes saber antes de pagar
Sin registro ni clave de API
La wallet que paga es la única identidad. No hay cuenta que crear, clave que guardar ni saldo que recargar.
Pagos en USDC sin gas
Quien paga firma una autorización EIP-3009 y el facilitador de Coinbase CDP envía la transferencia, así que la wallet necesita USDC pero no ETH.
Obtener el resultado
La mayoría de las tareas de medios terminan de forma asíncrona. La respuesta 200 incluye un poll_url con un token de acceso a la tarea de solo lectura. El token da acceso solo a esa tarea y ninguna otra, y permanece válido durante 30 días después de que la tarea termina.
Si una tarea falla
x402 no tiene reembolsos integrados. Cuando una tarea pagada termina en estado fallido, RunAPI registra una obligación de reembolso por el monto total recibido. Después, un operador lo devuelve a la wallet que pagó mediante una transferencia USDC separada; el reembolso no es automático.
Qué endpoints califican
x402 funciona en endpoints REST con un precio fijo por llamada. Los modelos facturados por tokens, segundos o caracteres, incluidos los endpoints de LLM, siguen necesitando una API key y créditos. El servidor MCP no acepta pagos x402.
Las API keys siguen funcionando
x402 es una forma adicional de pagar. Las solicitudes que envían una API key válida siguen usando los créditos de la cuenta como antes, y una solicitud con una key inválida recibe un 401 en lugar de una cotización de pago.
Cómo se ve el intercambio
Entrega la respuesta a cualquier cliente x402 v2 conectado a la wallet del agente. El cliente se encarga de firmar y reintentar:
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URLPrecios de ejemplo
El precio mínimo por llamada de algunos modelos que hoy aceptan x402. Los precios vienen del catálogo en vivo, y cada cotización 402 indica el monto exacto de esa solicitud.
| Modelo | Endpoint | Precio por llamada |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
Detalles del pago
RunAPI sigue el esquema exact de x402 v2 y solo acepta los valores siguientes. Cualquier otro valor se rechaza antes de que RunAPI pida al facilitador que liquide.
| Red | Base mainnet (eip155:8453) |
|---|---|
| Activo | USDC, contrato 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimales |
| Facilitador | Coinbase CDP |
| Autorización | EIP-3009, así que quien paga necesita USDC pero no ETH para gas |
| Límite | hasta 10 USDC por solicitud; las cotizaciones caducan a los 300 segundos |
FAQ sobre x402
¿Qué es x402?
x402 es un protocolo de pago abierto construido sobre el código de estado HTTP 402 Payment Required. Un servidor responde 402 con los requisitos de pago, el cliente paga con una autorización de stablecoin firmada y la solicitud se reintenta. Lo mantiene la x402 Foundation.
¿Necesito una cuenta de RunAPI para pagar con x402?
No. La wallet que paga es la identidad. RunAPI crea un perfil de wallet interno solo después de la primera liquidación exitosa y nunca pide un correo electrónico ni una API key.
¿Qué hace el facilitador de x402?
El facilitador verifica el pago firmado y envía la transferencia USDC en Base. RunAPI usa el facilitador Coinbase CDP, así que quien paga no necesita pagar gas.
¿Cuánto cuesta una solicitud?
Cada endpoint tiene un precio fijo por llamada. La cotización 402 muestra el monto exacto en USDC antes de firmar, y el catálogo de modelos indica los precios actuales.
¿Pueden los agentes descubrir RunAPI a través del x402 Bazaar?
Cada cotización 402 incluye una declaración de descubrimiento de Bazaar con el esquema de entrada y un ejemplo, para que los clientes y directorios x402 puedan listar el endpoint.
¿Qué pasa si pago y la solicitud falla antes de que empiece la tarea?
Una solicitud que falla la validación se rechaza antes de que se liquide el pago, así que no se cobra nada. Una vez liquidado el pago, una tarea que falla después recibe una obligación de reembolso completo.
Páginas relacionadas
El código de estado detrás de x402, y por qué las APIs lo devuelven.
Todos los modelos y endpoints disponibles en RunAPI.
Formatos de solicitud, consulta de tareas y códigos de error.
Ejecuta modelos desde una terminal o un shell de agente.
Deja que tu agente pague sus propias llamadas a la API
Explora los modelos, elige un endpoint por llamada y envía tu primera solicitud sin una key.