--- title: 'API x402: paga a richiesta i modelli IA in USDC, senza API key | RunAPI' description: Chiama modelli di immagini, video, musica e audio su RunAPI con x402. Il tuo agente paga ogni richiesta in USDC su Base, senza registrazione, API key o crediti. url: https://runapi.ai/it/x402.md canonical: https://runapi.ai/it/x402 locale: it 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/it/x402 > Site index for agents: https://runapi.ai/llms.txt # API x402 per modelli IA: paga a richiesta in USDC RunAPI accetta pagamenti x402 sui suoi endpoint a consumo. Un agente invia una richiesta normale, riceve un preventivo 402, lo firma con il proprio wallet e ottiene il risultato. Nessun account, nessuna API key, nessun credito prepagato. _Aggiornato September 24, 2026 · 6 min di lettura_ ## Key takeaways - Gli endpoint RunAPI idonei a consumo, con prezzo fino a 10 USDC, rispondono a una richiesta non autenticata con un preventivo x402 v2 standard. - Il pagamento viene regolato in USDC su Base tramite il facilitator Coinbase CDP. Chi paga firma un'autorizzazione EIP-3009 e non paga gas. - Una richiesta pagata restituisce la risposta normale più un poll_url di sola lettura, così un agente può recuperare il task completato senza account. - **155** risorse pagabili con x402 - **Base** rete di regolamento - **USDC** asset di pagamento - **0** API key richieste ## Quattro passaggi dalla richiesta al risultato 1. **Invia la richiesta senza una key** Invia lo stesso body JSON che invieresti con una API key, ma senza l'header Authorization. 2. **Leggi il preventivo 402** RunAPI risponde 402 con un header PAYMENT-REQUIRED che indica l'importo esatto, l'asset, la rete e il destinatario. Il preventivo è valido per 300 secondi. 3. **Firma e riprova** Il tuo client x402 v2 firma un'autorizzazione EIP-3009 con il wallet dell'agente e reinvia la richiesta con un header PAYMENT-SIGNATURE. 4. **Interroga il task** RunAPI regola il pagamento, avvia il task e restituisce 200 con una ricevuta PAYMENT-RESPONSE e un poll_url per il risultato. ## Come appare lo scambio La prima richiesta non porta credenziali. Per un endpoint a pagamento, RunAPI risponde con un 402 e i requisiti di pagamento: ```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: ``` Passa la risposta a qualsiasi client x402 v2 collegato al wallet dell'agente. Il client gestisce la firma e il nuovo tentativo: ```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 ``` ## Esempi di prezzi Il prezzo minimo per chiamata di alcuni modelli che oggi accettano x402. I prezzi provengono dal catalogo in tempo reale, e ogni preventivo 402 indica l'importo esatto per quella richiesta. | Modello | Endpoint | Prezzo per chiamata | | --- | --- | ---: | | 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 | ## Dettagli del pagamento RunAPI segue lo schema exact di x402 v2 e accetta solo i valori indicati di seguito. Qualsiasi altro valore viene rifiutato prima che RunAPI chieda al facilitator di regolare il pagamento. - Rete: Base mainnet (eip155:8453) - Asset: USDC, contratto 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimali - Facilitator: Coinbase CDP - Autorizzazione: EIP-3009, quindi chi paga ha bisogno di USDC ma non di ETH per il gas - Limite: fino a 10 USDC per richiesta; i preventivi scadono dopo 300 secondi ## Ottenere il risultato La maggior parte dei task media termina in modo asincrono. La risposta 200 include un poll_url con un token di accesso al task di sola lettura. Il token apre solo quel task e nient'altro, e resta valido per 30 giorni dopo il completamento del task. ## Se un task fallisce x402 non prevede rimborsi integrati. Quando un task pagato termina in stato di fallimento, RunAPI registra un obbligo di rimborso per l'intero importo ricevuto. Un operatore lo restituisce poi al wallet pagante con un trasferimento USDC separato; il rimborso non è automatico. ## Quali endpoint sono idonei x402 funziona su endpoint REST con un prezzo fisso per chiamata. I modelli fatturati per token, secondi o caratteri, inclusi gli endpoint LLM, richiedono ancora una API key e crediti. Il server MCP non accetta pagamenti x402. ## Le API key continuano a funzionare x402 è un modo di pagamento aggiuntivo. Le richieste che inviano una API key valida continuano a usare i crediti dell'account esattamente come prima, e una richiesta con una key non valida riceve un 401 invece di un preventivo di pagamento. ## FAQ su x402 ### Cos'è x402? x402 è un protocollo di pagamento aperto costruito sul codice di stato HTTP 402 Payment Required. Un server risponde 402 con i requisiti di pagamento, il client paga con un'autorizzazione stablecoin firmata, e la richiesta viene reinviata. È mantenuto dalla x402 Foundation. ### Mi serve un account RunAPI per pagare con x402? No. Il wallet che paga è l'identità. RunAPI crea un profilo wallet interno solo dopo il primo regolamento riuscito e non chiede mai un'email o una API key. ### Cosa fa il facilitator di x402? Il facilitator verifica il pagamento firmato e invia il bonifico USDC su Base. RunAPI usa il facilitator Coinbase CDP, quindi chi paga non deve pagare gas. ### Quanto costa una richiesta? Ogni endpoint ha un prezzo fisso per chiamata. Il preventivo 402 mostra l'importo esatto in USDC prima della firma, e il catalogo modelli elenca i prezzi correnti. ### Gli agenti possono scoprire RunAPI tramite l'x402 Bazaar? Ogni preventivo 402 include una dichiarazione di discovery Bazaar con lo schema di input e un esempio, così i client e le directory x402 possono elencare l'endpoint. ### Cosa succede se pago e la richiesta fallisce prima che un task parta? Una richiesta che fallisce la validazione viene rifiutata prima che il pagamento sia regolato, quindi non viene addebitato nulla. Una volta regolato il pagamento, un task che fallisce in seguito genera un obbligo di rimborso completo. ## Pagine correlate - [Cos'è HTTP 402?](https://runapi.ai/it/http-402.md) - Il codice di stato dietro x402, e perché le API lo restituiscono. - [Catalogo modelli](https://runapi.ai/it/models.md) - Tutti i modelli e gli endpoint disponibili su RunAPI. - [Documentazione per sviluppatori](https://runapi.ai/it/docs/guides) - Formati delle richieste, polling dei task e codici di errore. - [CLI](https://runapi.ai/it/cli.md) - Esegui modelli da un terminale o da una shell dell'agente. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## Lascia che il tuo agente paghi le proprie chiamate API Sfoglia i modelli, scegli un endpoint a consumo e invia la tua prima richiesta senza una key. - [Sfoglia i modelli](https://runapi.ai/it/models.md) - [Leggi la documentazione](https://runapi.ai/it/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/it/.md) ### Prodotto - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models#all-models) ### Sviluppatori - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) ### Guide - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [API x402](https://runapi.ai/it/x402.md) ### Azienda - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) ### Legale - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Article", "headline": "API x402: paga a richiesta i modelli IA in USDC, senza API key", "description": "Chiama modelli di immagini, video, musica e audio su RunAPI con x402. Il tuo agente paga ogni richiesta in USDC su Base, senza registrazione, API key o crediti.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it" }, "mainEntityOfPage": "https://runapi.ai/it/x402" }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "HowTo", "name": "Come pagare una richiesta RunAPI con x402", "description": "Un agente paga una richiesta RunAPI con USDC su Base usando il protocollo x402 v2.", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "Invia la richiesta senza una key", "text": "Invia lo stesso body JSON che invieresti con una API key, ma senza l'header Authorization.", "url": "https://runapi.ai/it/x402#four-step-getting-started-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Leggi il preventivo 402", "text": "RunAPI risponde 402 con un header PAYMENT-REQUIRED che indica l'importo esatto, l'asset, la rete e il destinatario. Il preventivo è valido per 300 secondi.", "url": "https://runapi.ai/it/x402#four-step-getting-started-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Firma e riprova", "text": "Il tuo client x402 v2 firma un'autorizzazione EIP-3009 con il wallet dell'agente e reinvia la richiesta con un header PAYMENT-SIGNATURE.", "url": "https://runapi.ai/it/x402#four-step-getting-started-step-3" }, { "@type": "HowToStep", "position": 4, "name": "Interroga il task", "text": "RunAPI regola il pagamento, avvia il task e restituisce 200 con una ricevuta PAYMENT-RESPONSE e un poll_url per il risultato.", "url": "https://runapi.ai/it/x402#four-step-getting-started-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Cos'è x402?", "acceptedAnswer": { "@type": "Answer", "text": "x402 è un protocollo di pagamento aperto costruito sul codice di stato HTTP 402 Payment Required. Un server risponde 402 con i requisiti di pagamento, il client paga con un'autorizzazione stablecoin firmata, e la richiesta viene reinviata. È mantenuto dalla x402 Foundation." } }, { "@type": "Question", "name": "Mi serve un account RunAPI per pagare con x402?", "acceptedAnswer": { "@type": "Answer", "text": "No. Il wallet che paga è l'identità. RunAPI crea un profilo wallet interno solo dopo il primo regolamento riuscito e non chiede mai un'email o una API key." } }, { "@type": "Question", "name": "Cosa fa il facilitator di x402?", "acceptedAnswer": { "@type": "Answer", "text": "Il facilitator verifica il pagamento firmato e invia il bonifico USDC su Base. RunAPI usa il facilitator Coinbase CDP, quindi chi paga non deve pagare gas." } }, { "@type": "Question", "name": "Quanto costa una richiesta?", "acceptedAnswer": { "@type": "Answer", "text": "Ogni endpoint ha un prezzo fisso per chiamata. Il preventivo 402 mostra l'importo esatto in USDC prima della firma, e il catalogo modelli elenca i prezzi correnti." } }, { "@type": "Question", "name": "Gli agenti possono scoprire RunAPI tramite l'x402 Bazaar?", "acceptedAnswer": { "@type": "Answer", "text": "Ogni preventivo 402 include una dichiarazione di discovery Bazaar con lo schema di input e un esempio, così i client e le directory x402 possono elencare l'endpoint." } }, { "@type": "Question", "name": "Cosa succede se pago e la richiesta fallisce prima che un task parta?", "acceptedAnswer": { "@type": "Answer", "text": "Una richiesta che fallisce la validazione viene rifiutata prima che il pagamento sia regolato, quindi non viene addebitato nulla. Una volta regolato il pagamento, un task che fallisce in seguito genera un obbligo di rimborso completo." } } ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/it" }, { "@type": "ListItem", "position": 2, "name": "API x402", "item": "https://runapi.ai/it/x402" } ] } ] ```