API x402 dla modeli AI: płatność za żądanie w USDC
RunAPI akceptuje płatności x402 na swoich endpointach rozliczanych za wywołanie. Agent wysyła zwykłe żądanie, otrzymuje wycenę 402, podpisuje ją portfelem i dostaje wynik. Bez konta, bez klucza API, bez przedpłaconych kredytów.
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 zasobów płatnych przez x402
- Base sieć rozliczeniowa
- USDC aktywo płatnicze
- 0 wymaganych kluczy API
Cztery kroki od żądania do wyniku
-
Wyślij żądanie bez klucza
Wyślij metodą POST to samo body JSON, które wysłałbyś z kluczem API, ale bez nagłówka Authorization.
-
Odczytaj wycenę 402
RunAPI odpowiada kodem 402 z nagłówkiem PAYMENT-REQUIRED, który podaje dokładną kwotę, aktywo, sieć i odbiorcę. Wycena jest ważna przez 300 sekund.
-
Podpisz i ponów żądanie
Twój klient x402 v2 podpisuje autoryzację EIP-3009 portfelem agenta i ponawia żądanie z nagłówkiem PAYMENT-SIGNATURE.
-
Sprawdź status zadania
RunAPI rozlicza płatność, uruchamia zadanie i zwraca kod 200 z potwierdzeniem PAYMENT-RESPONSE oraz poll_url do pobrania wyniku.
Co warto wiedzieć przed płatnością
Bez rejestracji i klucza API
Płacący portfel jest jedyną tożsamością. Nie trzeba zakładać konta, przechowywać klucza ani doładowywać salda.
Płatności USDC bez opłat za gas
Płatnik podpisuje autoryzację EIP-3009, a facylitator Coinbase CDP wysyła przelew, więc portfel potrzebuje USDC, ale nie ETH.
Odbiór wyniku
Większość zadań na plikach multimedialnych kończy się asynchronicznie. Odpowiedź 200 zawiera poll_url z tokenem dostępu do zadania przeznaczonym tylko do odczytu. Token otwiera wyłącznie to jedno zadanie i nic więcej, i pozostaje ważny przez 30 dni po jego zakończeniu.
Gdy zadanie zakończy się niepowodzeniem
x402 nie ma wbudowanych zwrotów. Gdy opłacone zadanie kończy się niepowodzeniem, RunAPI rejestruje zobowiązanie zwrotu pełnej otrzymanej kwoty. Następnie operator zwraca ją do płacącego portfela osobnym przelewem USDC; zwrot nie następuje automatycznie.
Które endpointy się kwalifikują
x402 działa na endpointach REST z ustaloną ceną za wywołanie. Modele rozliczane według tokenów, sekund lub znaków, w tym endpointy LLM, nadal wymagają klucza API i kredytów. Serwer MCP nie przyjmuje płatności x402.
Klucze API nadal działają
x402 to dodatkowy sposób płatności. Żądania z ważnym kluczem API nadal korzystają z kredytów konta tak jak wcześniej, a żądanie z nieprawidłowym kluczem otrzymuje kod 401 zamiast wyceny płatności.
Jak wygląda ta wymiana
Przekaż odpowiedź dowolnemu klientowi x402 v2 połączonemu z portfelem agenta. Klient zajmuje się podpisaniem i ponowieniem żądania:
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 URLPrzykładowe ceny
Najniższa cena za wywołanie kilku modeli, które obecnie akceptują x402. Ceny pochodzą z aktualnego katalogu, a każda wycena 402 podaje dokładną kwotę dla danego żądania.
| Model | Endpoint | Cena za wywołanie |
|---|---|---|
| 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 |
Szczegóły płatności
RunAPI stosuje schemat exact z x402 v2 i akceptuje wyłącznie wartości podane poniżej. Wszystko inne jest odrzucane, zanim RunAPI poprosi facylitatora o rozliczenie.
| Sieć | Base mainnet (eip155:8453) |
|---|---|
| Aktywo | USDC, kontrakt 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 miejsc po przecinku |
| Facylitator | Coinbase CDP |
| Autoryzacja | EIP-3009, więc płacący potrzebuje USDC, ale nie ETH na gas |
| Limit | do 10 USDC za żądanie; wyceny wygasają po 300 sekundach |
FAQ o x402
Czym jest x402?
x402 to otwarty protokół płatności zbudowany na kodzie stanu HTTP 402 Payment Required. Serwer odpowiada kodem 402 z wymaganiami płatności, klient płaci podpisaną autoryzacją stablecoina, a żądanie jest ponawiane. Protokół utrzymuje x402 Foundation.
Czy potrzebuję konta RunAPI, aby zapłacić za pomocą x402?
Nie. Tożsamością jest portfel, który płaci. RunAPI tworzy wewnętrzny profil portfela dopiero po pierwszym udanym rozliczeniu i nigdy nie prosi o adres e-mail ani klucz API.
Co robi facylitator x402?
Facylitator weryfikuje podpisaną płatność i wysyła przelew USDC na Base. RunAPI korzysta z facylitatora Coinbase CDP, więc płacący nie musi płacić za gas.
Ile kosztuje żądanie?
Każdy endpoint ma ustaloną cenę za wywołanie. Wycena 402 pokazuje dokładną kwotę w USDC przed podpisaniem, a katalog modeli podaje aktualne ceny.
Czy agenty mogą odkryć RunAPI przez x402 Bazaar?
Każda wycena 402 zawiera deklarację odkrywania Bazaar ze schematem danych wejściowych i przykładem, dzięki czemu klienci i katalogi x402 mogą wyświetlić dany endpoint.
Co się stanie, jeśli zapłacę, a żądanie zawiedzie przed rozpoczęciem zadania?
Żądanie, które nie przechodzi walidacji, jest odrzucane przed rozliczeniem płatności, więc nic nie jest pobierane. Po rozliczeniu płatności zadanie, które później zawiedzie, otrzymuje pełne zobowiązanie zwrotu.
Powiązane strony
Pozwól swojemu agentowi płacić za własne wywołania API
Przejrzyj modele, wybierz endpoint rozliczany za wywołanie i wyślij pierwsze żądanie bez klucza.