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.
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 risorse pagabili con x402
- Base rete di regolamento
- USDC asset di pagamento
- 0 API key richieste
Quattro passaggi dalla richiesta al risultato
-
Invia la richiesta senza una key
Invia lo stesso body JSON che invieresti con una API key, ma senza l'header Authorization.
-
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.
-
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.
-
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.
Cosa sapere prima di pagare
Nessuna registrazione, nessuna chiave API
Il wallet che paga è l'unica identità. Non devi creare account, conservare chiavi o ricaricare un saldo.
Pagamenti USDC senza gas
Chi paga firma un'autorizzazione EIP-3009 e il facilitator Coinbase CDP invia il trasferimento, quindi il wallet ha bisogno di USDC ma non di ETH.
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.
Come appare lo scambio
Passa la risposta a qualsiasi client x402 v2 collegato al wallet dell'agente. Il client gestisce la firma e il nuovo tentativo:
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 URLEsempi 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 |
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
Il codice di stato dietro x402, e perché le API lo restituiscono.
Tutti i modelli e gli endpoint disponibili su RunAPI.
Formati delle richieste, polling dei task e codici di errore.
Esegui modelli da un terminale o da una shell dell'agente.
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.