x402 API für KI-Modelle: pro Anfrage in USDC bezahlen
RunAPI akzeptiert x402-Zahlungen auf seinen nutzungsbasierten Endpoints. Ein Agent sendet eine normale Anfrage, erhält ein 402-Angebot, signiert es mit seiner Wallet und erhält das Ergebnis. Kein Konto, kein API Key, kein vorausbezahltes Guthaben.
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 mit x402 bezahlbare Ressourcen
- Base Abwicklungsnetzwerk
- USDC Zahlungsmittel
- 0 erforderliche API Keys
Vier Schritte von der Anfrage zum Ergebnis
-
Anfrage ohne Key senden
Senden Sie per POST denselben JSON-Body wie mit einem API Key, aber ohne den Authorization-Header.
-
Das 402-Angebot lesen
RunAPI antwortet mit 402 und einem PAYMENT-REQUIRED-Header, der den genauen Betrag, das Zahlungsmittel, das Netzwerk und den Empfänger angibt. Das Angebot ist 300 Sekunden gültig.
-
Signieren und erneut senden
Ihr x402-v2-Client signiert mit der Agenten-Wallet eine EIP-3009-Autorisierung und sendet die Anfrage mit einem PAYMENT-SIGNATURE-Header erneut.
-
Die Aufgabe abfragen
RunAPI wickelt die Zahlung ab, startet die Aufgabe und liefert 200 mit einer PAYMENT-RESPONSE-Quittung und einer poll_url für das Ergebnis.
Was Sie vor dem Bezahlen wissen sollten
Keine Registrierung, kein API-Schlüssel
Die zahlende Wallet ist die einzige Identität. Sie müssen kein Konto anlegen, keinen Schlüssel speichern und kein Guthaben aufladen.
USDC-Zahlungen ohne Gas
Der Zahler signiert eine EIP-3009-Autorisierung und der Coinbase-CDP-Facilitator reicht die Überweisung ein. Die Wallet braucht USDC, aber kein ETH.
Das Ergebnis abrufen
Die meisten Media-Aufgaben werden asynchron abgeschlossen. Die 200-Antwort enthält eine poll_url mit einem schreibgeschützten Task-Zugriffstoken. Das Token öffnet nur diese eine Aufgabe und sonst nichts und bleibt 30 Tage nach Abschluss der Aufgabe gültig.
Wenn eine Aufgabe fehlschlägt
x402 hat keine eingebaute Rückerstattung. Wenn eine bezahlte Aufgabe fehlschlägt, verbucht RunAPI eine Rückerstattungsverpflichtung über den vollen erhaltenen Betrag. Ein Operator überweist ihn anschließend per separater USDC-Transaktion an die zahlende Wallet zurück; die Rückerstattung erfolgt nicht automatisch.
Welche Endpoints infrage kommen
x402 funktioniert bei REST-Endpoints mit einem festen Preis pro Aufruf. Modelle, die nach Token, Sekunden oder Zeichen abgerechnet werden, einschließlich der LLM-Endpoints, benötigen weiterhin einen API Key und Guthaben. Der MCP-Server nimmt keine x402-Zahlungen an.
API Keys funktionieren weiterhin
x402 ist eine zusätzliche Zahlungsmöglichkeit. Anfragen mit einem gültigen API Key nutzen weiterhin wie gewohnt das Kontoguthaben, und eine Anfrage mit einem ungültigen Key erhält statt eines Zahlungsangebots ein 401.
So sieht der Austausch aus
Übergeben Sie die Antwort an einen beliebigen x402-v2-Client, der mit der Agenten-Wallet verbunden ist. Der Client übernimmt Signierung und erneute Anfrage:
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 URLBeispielpreise
Der niedrigste Preis pro Aufruf für einige Modelle, die x402 heute akzeptieren. Die Preise stammen aus dem Live-Katalog, und jedes 402-Angebot nennt den genauen Betrag für diese Anfrage.
| Modell | Endpoint | Preis pro Aufruf |
|---|---|---|
| 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 |
Zahlungsdetails
RunAPI folgt dem exact-Schema von x402 v2 und akzeptiert nur die unten genannten Werte. Alles andere wird abgelehnt, bevor RunAPI den Facilitator um die Abwicklung bittet.
| Netzwerk | Base Mainnet (eip155:8453) |
|---|---|
| Zahlungsmittel | USDC, Contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 Dezimalstellen |
| Facilitator | Coinbase CDP |
| Autorisierung | EIP-3009, daher benötigt der Zahler USDC, aber kein ETH für Gas |
| Limit | bis zu 10 USDC pro Anfrage; Angebote laufen nach 300 Sekunden ab |
x402-FAQ
Was ist x402?
x402 ist ein offenes Zahlungsprotokoll auf Basis des HTTP-Statuscodes 402 Payment Required. Ein Server antwortet mit 402 und den Zahlungsanforderungen, der Client zahlt mit einer signierten Stablecoin-Autorisierung, und die Anfrage wird erneut gesendet. Es wird von der x402 Foundation gepflegt.
Brauche ich ein RunAPI-Konto, um mit x402 zu bezahlen?
Nein. Die zahlende Wallet ist die Identität. RunAPI legt erst nach der ersten erfolgreichen Abwicklung ein internes Wallet-Profil an und fragt nie nach einer E-Mail-Adresse oder einem API Key.
Was macht der x402-Facilitator?
Der Facilitator prüft die signierte Zahlung und veranlasst die USDC-Überweisung auf Base. RunAPI nutzt den Coinbase-CDP-Facilitator, sodass der Zahler kein Gas zahlen muss.
Wie viel kostet eine Anfrage?
Jeder Endpoint hat einen festen Preis pro Aufruf. Das 402-Angebot zeigt den genauen USDC-Betrag vor der Signierung an, und der Modellkatalog listet die aktuellen Preise auf.
Können Agenten RunAPI über den x402 Bazaar entdecken?
Jedes 402-Angebot enthält eine Bazaar-Discovery-Deklaration mit dem Input-Schema und einem Beispiel, sodass x402-Clients und -Verzeichnisse den Endpoint listen können.
Was passiert, wenn ich zahle und die Anfrage fehlschlägt, bevor eine Aufgabe startet?
Eine Anfrage, die die Validierung nicht besteht, wird abgelehnt, bevor die Zahlung abgewickelt wird, sodass nichts berechnet wird. Ist die Zahlung erst abgewickelt, entsteht bei einer später fehlschlagenden Aufgabe eine vollständige Rückerstattungsverpflichtung.
Verwandte Seiten
Lassen Sie Ihren Agenten für seine eigenen API-Aufrufe bezahlen
Durchsuchen Sie die Modelle, wählen Sie einen nutzungsbasierten Endpoint und senden Sie Ihre erste Anfrage ohne Key.