Lass AI-Agenten mit OKXselbst bezahlen und sich registrieren
Mit der OKX Wallet über x402 zahlen und API key und Guthaben in einer Anfrage erhalten.
- USD₮0 auf X Layer, über OKX abgewickelt
- Keine Kreditkarte und kein Anmeldeformular
- Auch normale Nutzer können per x402 aufladen
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}Was ist x402
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
Zahlungen werden über den x402 facilitator von OKX auf X Layer on-chain abgewickelt; der Server prüft jede einzelne, bevor er handelt.
HTTP 402 fordert Zahlung an
Der Server antwortet mit 402 und nennt Netzwerk, Asset, Betrag und Empfangsadresse. Der Client signiert eine Zahlungsautorisierung und sendet dieselbe Anfrage erneut. BazaarLink wickelt jede Zahlung über den x402 facilitator von OKX auf X Layer ab.
api_keysk-bl-…credits5claim_token…payment.txHash0x…Kein Konto im Voraus nötig
Ein agent muss vorher kein Formular ausfüllen und kein Konto anlegen. Die Anfrage mit der Zahlung legt das Konto an, stellt API key aus und schreibt Guthaben gut.
Vier Schritte von der Anfrage zum API key
Anfrage senden
POST an /api/v1/agents/register/x402 mit Name und gewünschtem Betrag in US-Dollar.
402 erhalten
Der Server antwortet mit 402 und den Zahlungsanforderungen. Zu diesem Zeitpunkt wird nichts angelegt.
Signieren und erneut senden
Die Zahlungsautorisierung mit der eigenen Wallet signieren, in den X-PAYMENT-Header setzen und dieselbe Anfrage erneut senden.
API key erhalten
Nach der Zahlungsbestätigung kommt eine 201-Antwort mit API key, Guthaben und einem Übernahmelink. Der API key erscheint nur in dieser Antwort; speichere ihn sofort.
Schon ein Konto? Auch per x402 aufladen
Agenten verwenden ihren vorhandenen API key. Normale Nutzer melden sich an und laden auf der Guthabenseite auf.
Agenten und Skripte
POST an /api/x402/topup mit Authorization-Header und amountUsd. Der Ablauf entspricht der Registrierung: Angebot, Signatur, erneutes Senden.
Normale Nutzer
Anmelden, auf der Guthabenseite x402 wählen und die Zahlung mit der Browser-Wallet signieren.
Unterstütztes Netzwerk und Asset
Derzeit wird eine Kombination unterstützt.
- Netzwerk
- X Layer, über den x402 facilitator von OKX abgewickelt
- Asset
- USD₮0
- Guthaben
- Es fällt eine Plattform-Aufladegebühr an, daher liegt das gutgeschriebene Guthaben unter dem gezahlten Betrag (siehe Preise)
- Betrag pro Zahlung
- Es gibt einen Mindest- und Höchstbetrag; die aktuellen Grenzen stehen in der 402-Antwort und unter GET /api/x402/topup
On-chain-Zahlungen können nicht rückgängig gemacht werden. Prüfe Betrag und Netzwerk vor dem Signieren.
Noch nicht bezahlt? Kostenlose Modelle funktionieren weiterhin
Ein unbezahltes agent-Konto nutzt das bestehende Kontingent für kostenlose Modelle und die Ratenlimits (auto:free). Nach der Zahlung gelten die normalen Regeln für bezahlte Konten.
Häufige Fragen
Was ist x402?
x402 ist ein Protokoll, das mit dem HTTP-Statuscode 402 eine Zahlung anfordert. Der Server nennt Betrag, Netzwerk und Empfangsadresse; der Client signiert die Zahlungsautorisierung und sendet dieselbe Anfrage erneut.
Was brauche ich für eine Zahlung mit x402?
Die OKX Wallet oder ein Wallet-Schlüssel, der eine EIP-3009-Autorisierung signieren kann, sowie USD₮0 auf X Layer. Die Integrationsdoku enthält TypeScript-Code, der dafür den x402-Client nutzt.
Welche Netzwerke und Assets werden unterstützt?
USD₮0 auf X Layer, abgewickelt über den x402-Facilitator von OKX. Es fällt eine Plattform-Aufladegebühr an, daher ist das erhaltene Guthaben niedriger als der gezahlte Betrag; siehe Preise.
Was passiert bei doppelter Zahlung oder erneutem Senden?
Jede Zahlung wird nur einmal gutgeschrieben. Beim erneuten Senden derselben Zahlung zum Aufladen kommt already_credited zurück. Bei der Registrierung kommt 15 Minuten lang dasselbe Ergebnis zurück; danach already_registered, und der API key wird nicht erneut angezeigt.
Kann ich eine Rückerstattung erhalten?
On-chain-Zahlungen können nicht rückgängig gemacht werden, und das System erstattet nicht automatisch. Wende dich bei Problemen an den Support.
Gibt es ein Registrierungslimit?
Ja. Registrierungen aus derselben Netzwerkquelle sind kurzfristig begrenzt. Bei Erreichen des Limits kommt 429 mit einem Retry-After-Header; warte und versuche es erneut.
Kann eine Person ein agent-Konto übernehmen?
Ja. Die Registrierungsantwort enthält claim_token und upgrade_url. Eine Person meldet sich an und übernimmt das Konto; API key und Guthaben wechseln in dieses Konto. claim_expires nennt die Frist.