--- title: 'API x402: paga por solicitud modelos de IA en USDC, sin API key | RunAPI' description: Llama a modelos de imagen, video, música y audio en RunAPI con x402. Tu agente paga cada solicitud en USDC en Base, sin registro, API key ni créditos. url: https://runapi.ai/es/x402.md canonical: https://runapi.ai/es/x402 locale: es updated: '2026-09-24' date: '2026-09-24' site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/x402 zh-CN: https://runapi.ai/zh-CN/x402 es: https://runapi.ai/es/x402 ja: https://runapi.ai/ja/x402 de: https://runapi.ai/de/x402 fr: https://runapi.ai/fr/x402 pt-BR: https://runapi.ai/pt-BR/x402 ko: https://runapi.ai/ko/x402 it: https://runapi.ai/it/x402 nl: https://runapi.ai/nl/x402 pl: https://runapi.ai/pl/x402 tr: https://runapi.ai/tr/x402 zh-TW: https://runapi.ai/zh-TW/x402 zh-HK: https://runapi.ai/zh-HK/x402 ar: https://runapi.ai/ar/x402 x-default: https://runapi.ai/x402 --- > HTML version: https://runapi.ai/es/x402 > Site index for agents: https://runapi.ai/llms.txt # 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. _Actualizado September 24, 2026 · 6 min de lectura_ ## Key takeaways - Los endpoints de RunAPI por llamada que cumplen los requisitos, con precio de hasta 10 USDC, responden a una solicitud sin autenticar con una cotización x402 v2 estándar. - El pago se liquida en USDC en Base a través del facilitador Coinbase CDP. Quien paga firma una autorización EIP-3009 y no paga gas. - Una solicitud pagada devuelve la respuesta normal más un poll_url de solo lectura, para que un agente pueda obtener la tarea terminada sin cuenta. - **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 1. **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. 2. **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. 3. **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. 4. **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. ## Cómo se ve el intercambio La primera solicitud no lleva credenciales. En un endpoint pagable, RunAPI responde con un 402 y los requisitos de pago: ```shell 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: ``` Entrega la respuesta a cualquier cliente x402 v2 conectado a la wallet del agente. El cliente se encarga de firmar y reintentar: ```text 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 # => 200 response.headers["PAYMENT-RESPONSE"] # settlement receipt response.json["poll_url"] # read-only task result URL ``` ## Precios 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 ## 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. ## 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 - [¿Qué es HTTP 402?](https://runapi.ai/es/http-402.md) - El código de estado detrás de x402, y por qué las APIs lo devuelven. - [Catálogo de modelos](https://runapi.ai/es/models.md) - Todos los modelos y endpoints disponibles en RunAPI. - [Documentación para desarrolladores](https://runapi.ai/es/docs/guides) - Formatos de solicitud, consulta de tareas y códigos de error. - [CLI](https://runapi.ai/es/cli.md) - Ejecuta modelos desde una terminal o un shell de agente. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## 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. - [Explorar modelos](https://runapi.ai/es/models.md) - [Leer la documentación](https://runapi.ai/es/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/es/.md) ### Producto - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models#all-models) ### Desarrolladores - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) ### Guías - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [API x402](https://runapi.ai/es/x402.md) ### Empresa - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) ### Legal - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Article", "headline": "API x402: paga por solicitud modelos de IA en USDC, sin API key", "description": "Llama a modelos de imagen, video, música y audio en RunAPI con x402. Tu agente paga cada solicitud en USDC en Base, sin registro, API key ni créditos.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es" }, "mainEntityOfPage": "https://runapi.ai/es/x402" }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "HowTo", "name": "Cómo pagar una solicitud a RunAPI con x402", "description": "Un agente paga una solicitud a RunAPI con USDC en Base usando el protocolo x402 v2.", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "Envía la solicitud sin una key", "text": "Haz un POST con el mismo cuerpo JSON que enviarías con una API key, pero sin el encabezado Authorization.", "url": "https://runapi.ai/es/x402#four-step-getting-started-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Lee la cotización 402", "text": "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.", "url": "https://runapi.ai/es/x402#four-step-getting-started-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Firma y reintenta", "text": "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.", "url": "https://runapi.ai/es/x402#four-step-getting-started-step-3" }, { "@type": "HowToStep", "position": 4, "name": "Consulta la tarea", "text": "RunAPI liquida el pago, inicia la tarea y devuelve 200 con un recibo PAYMENT-RESPONSE y un poll_url para el resultado.", "url": "https://runapi.ai/es/x402#four-step-getting-started-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "¿Qué es x402?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "¿Necesito una cuenta de RunAPI para pagar con x402?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "¿Qué hace el facilitador de x402?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "¿Cuánto cuesta una solicitud?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "¿Pueden los agentes descubrir RunAPI a través del x402 Bazaar?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "¿Qué pasa si pago y la solicitud falla antes de que empiece la tarea?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Inicio", "item": "https://runapi.ai/es" }, { "@type": "ListItem", "position": 2, "name": "API x402", "item": "https://runapi.ai/es/x402" } ] } ] ```