x402 API voor AI-modellen: betaal per verzoek in USDC
RunAPI accepteert x402-betalingen op zijn endpoints per aanroep. Een agent stuurt een normaal verzoek, krijgt een 402-offerte, ondertekent die met zijn wallet en ontvangt het resultaat. Geen account, geen API-key, geen vooraf betaalde credits.
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 resources betaalbaar met x402
- Base afwikkelingsnetwerk
- USDC betaalmiddel
- 0 vereiste API-keys
Vier stappen van verzoek naar resultaat
-
Stuur het verzoek zonder key
Verstuur dezelfde JSON-body via POST die je met een API-key zou sturen, maar laat de Authorization-header weg.
-
Lees de 402-offerte
RunAPI antwoordt met 402 en een PAYMENT-REQUIRED-header met het exacte bedrag, het betaalmiddel, het netwerk en de ontvanger. De offerte is 300 seconden geldig.
-
Onderteken en probeer opnieuw
Je x402 v2-client ondertekent een EIP-3009-autorisatie met de agentwallet en herhaalt het verzoek met een PAYMENT-SIGNATURE-header.
-
Vraag de taakstatus op
RunAPI wikkelt de betaling af, start de taak en geeft 200 terug met een PAYMENT-RESPONSE-bewijs en een poll_url voor het resultaat.
Wat je moet weten voordat je betaalt
Geen registratie, geen API-sleutel
De betalende wallet is de enige identiteit. Je hoeft geen account aan te maken, geen sleutel te bewaren en geen tegoed op te waarderen.
USDC-betalingen zonder gas
De betaler ondertekent een EIP-3009-autorisatie en de Coinbase CDP-facilitator dient de overboeking in, dus de wallet heeft USDC nodig maar geen ETH.
Het resultaat ophalen
De meeste mediataken worden asynchroon afgerond. De 200-respons bevat een poll_url met een alleen-lezen toegangstoken voor de taak. Het token geeft toegang tot precies die ene taak en niets anders, en blijft 30 dagen geldig nadat de taak is afgerond.
Als een taak mislukt
x402 kent geen ingebouwde terugbetalingen. Wanneer een betaalde taak in een mislukte status eindigt, registreert RunAPI een terugbetalingsverplichting voor het volledige ontvangen bedrag. Een operator stuurt dit daarna terug naar de betalende wallet via een aparte USDC-overboeking; de terugbetaling gebeurt niet automatisch.
Welke endpoints komen in aanmerking
x402 werkt op REST-endpoints met een vaste prijs per aanroep. Modellen die per token, seconde of teken worden gefactureerd, inclusief de LLM-endpoints, vereisen nog steeds een API-key en credits. De MCP-server accepteert geen x402-betalingen.
API-keys blijven werken
x402 is een extra manier om te betalen. Verzoeken met een geldige API-key blijven precies zoals voorheen accountcredits gebruiken, en een verzoek met een ongeldige key krijgt een 401 in plaats van een betalingsofferte.
Hoe de uitwisseling eruitziet
Geef de respons door aan elke x402 v2-client die met de agentwallet is verbonden. De client verzorgt het ondertekenen en de herhaling:
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 URLVoorbeeldprijzen
De laagste prijs per aanroep voor een aantal modellen die vandaag x402 accepteren. De prijzen komen uit de actuele catalogus, en elke 402-offerte vermeldt het exacte bedrag voor dat verzoek.
| Model | Endpoint | Prijs per aanroep |
|---|---|---|
| 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 |
Betalingsdetails
RunAPI volgt het exact-schema van x402 v2 en accepteert alleen de onderstaande waarden. Al het andere wordt geweigerd voordat RunAPI de facilitator om afwikkeling vraagt.
| Netwerk | Base mainnet (eip155:8453) |
|---|---|
| Betaalmiddel | USDC, contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 decimalen |
| Facilitator | Coinbase CDP |
| Autorisatie | EIP-3009, dus de betaler heeft USDC nodig maar geen ETH voor gas |
| Limiet | tot 10 USDC per verzoek; offertes verlopen na 300 seconden |
x402 FAQ
Wat is x402?
x402 is een open betalingsprotocol gebouwd op de HTTP-statuscode 402 Payment Required. Een server antwoordt met 402 en de betalingsvereisten, de client betaalt met een ondertekende stablecoin-autorisatie, en het verzoek wordt opnieuw uitgevoerd. Het wordt beheerd door de x402 Foundation.
Heb ik een RunAPI-account nodig om met x402 te betalen?
Nee. De wallet die betaalt, is de identiteit. RunAPI maakt pas na de eerste succesvolle afwikkeling een intern walletprofiel aan en vraagt nooit om een e-mailadres of API-key.
Wat doet de x402-facilitator?
De facilitator verifieert de ondertekende betaling en dient de USDC-overboeking in op Base. RunAPI gebruikt de Coinbase CDP-facilitator, dus de betaler hoeft geen gas te betalen.
Hoeveel kost een verzoek?
Elk endpoint heeft een vaste prijs per aanroep. De 402-offerte toont het exacte USDC-bedrag voordat je ondertekent, en de modelcatalogus vermeldt de actuele prijzen.
Kunnen agenten RunAPI ontdekken via de x402 Bazaar?
Elke 402-offerte bevat een Bazaar-ontdekkingsverklaring met het invoerschema en een voorbeeld, zodat x402-clients en -directories het endpoint kunnen vermelden.
Wat gebeurt er als ik betaal en het verzoek mislukt voordat een taak start?
Een verzoek dat de validatie niet doorstaat, wordt geweigerd voordat de betaling wordt afgewikkeld, dus er wordt niets in rekening gebracht. Zodra de betaling is afgewikkeld, krijgt een taak die later mislukt een volledige terugbetalingsverplichting.
Gerelateerde pagina's
Laat je agent zelf voor zijn API-aanroepen betalen
Blader door de modellen, kies een endpoint per aanroep en stuur je eerste verzoek zonder key.