Kluczowy wniosek
X402 nie jest odrębnym systemem cenowym. Każde wywołanie API ma już koszt wyrażony w Credits, który jest jedynym źródłem ceny wspólnym dla wszystkich metod rozliczeń (potrącanie limitów przez API Token, saldo konta, płatność on-chain X402). X402 jedynie przelicza ten koszt Credits na on-chain USDC według stałego kursu:
1 Credit = 0.095215 USDC (czyli 95215 atomic USDC, USDC ma 6 miejsc po przecinku)
Oznacza to:
Podstawa wyceny
Przeliczenie jest realizowane jednolicie przez platformę, a kwota jest taka sama dla wszystkich obsługiwanych sieci (Base, Solana); różne sieci różnią się jedynie kontraktem aktywa i sposobem podpisywania, cena pozostaje taka sama.
Relacja ze zwykłą ceną jednostkową Credits
Platforma sprzedaje Credits w progach „im większe użycie, tym niższa cena jednostkowa”. Podczas rozliczania X402 za wywołanie zawsze stosowana jest najlepsza stawka z progów:
Innymi słowy, X402 rozlicza każde wywołanie według najlepszej ceny jednostkowej Credits. Użytkownicy kupujący Credits przez małe doładowania płacą wyższą cenę jednostkową niż w X402; tylko użytkownicy dokonujący dużych doładowań mają taką samą cenę jednostkową jak X402.
Dwie formy ceny: exact i upto
W odpowiedzi 402 X402, maxAmountRequired to kwota, którą należy podpisać. Występuje ona w dwóch formach:
exact(stała cena): Cena może zostać określona przed przetworzeniem żądania (obrazy, wideo, muzyka, wyszukiwanie, płatności za zamówienia).maxAmountRequired = koszt Credits wywołania × 0.095215, czyli kwota należna za dane wywołanie (zgodna zcost.amountw pomyślnej odpowiedzi).upto(pomiar użycia po zakończeniu): Interfejsy takie jak uzupełnianie czatu, gdzie „dopiero po zakończeniu odpowiedzi wiadomo, ile tokenów zostało użytych”.maxAmountRequiredjest limitem górnym (przeliczonym według limitu ustalonego dla danego modelu: maksymalne Credits × 0.095215), a rzeczywista opłata jest rozliczana według faktycznego użycia i nie przekracza limitu.
exact i upto. Poniżej omawiane są wyłącznie ceny.
Ceny Chat (uzupełnianie czatu)
Uzupełnianie czatu jest mierzone w trybieupto: opłata naliczana jest według faktycznego użycia tokenów prompt / completion. Cena za milion (1M) tokenów = koszt Credits danego modelu za 1M tokenów × 0.095215, co jest w pełni zgodne z ceną USD wyświetlaną w publicznym katalogu modeli platformy (/api/v1/models?with_pricing=true).
Poniższa tabela przedstawia rzeczywiste ceny (pobrane z katalogu modeli i przeliczone według kursu X402), w USD / 1M tokenów:
Uwagi:
- Tabela przedstawia ceny jednostkowe mierzone według tokenów; koszt jednego żądania = tokeny wejściowe × cena jednostkowa wejścia + tokeny wyjściowe × cena jednostkowa wyjścia.
- Limit
uptoto maksymalna kwota, jaką można podpisać dla jednego żądania danego modelu; nie jest to faktycznie pobierana opłata, a zdecydowana większość żądań pozostaje znacznie poniżej limitu. - Limit określa jedynie „ile maksymalnie może zostać pobrane”; faktyczne rozliczenie jest obliczane na podstawie użycia tokenów.
Przykład: wycena i pobrana opłata są zgodne (exact)
Poniżej znajduje się jedno rzeczywiste płatne wywołanie wykonane za pomocą oficjalnego X402Client do serp/google (Base exact). Pokazuje ono zgodność trzech wartości: wyceny 402, podpisanej kwoty oraz cost zwróconego w pomyślnej odpowiedzi.
cost.amount (0.000952 USDC) jest w pełni zgodne z wyceną 402 oraz z Credits × 0.095215. Pole settlement jest statusem rozliczenia tej płatności (authorized = autoryzowana); rozliczenie on-chain jest obsługiwane przez platformę, mechanizm opisano w schematach rozliczeń exact i upto.
Obliczanie wyceny upto (czat)
Czat jest rozliczany według tokenów. Wycena danego żądania (nie limit górny) jest obliczana według poniższego wzoru (na przykładzie gpt-4o-mini):
upto (dla gpt-4o-mini 1 Credit = 95215 atomic), co oznacza jedynie, ile maksymalnie może zostać pobrane; rzeczywista wycena tego żądania (w powyższym przykładzie około $0.0001) jest znacznie niższa od limitu i jest rozliczana według zużycia tokenów. Mechanizm rozliczenia on-chain dla upto opisano w schematach rozliczeń exact i upto.
Ceny innych usług (stała cena exact)
W przypadku interfejsów takich jak obrazy, wideo, muzyka i wyszukiwanie cena może zostać określona w momencie żądania, dlatego używany jest model exact. Poniższa tabela zawiera rzeczywiste ceny, pobrane z pola 402 maxAmountRequired zwracanego przez aktywne interfejsy dla nieopłaconych żądań (zapytanie o wycenę nie powoduje naliczenia opłaty):
Uwagi:
- Cena tej samej usługi zmienia się zależnie od modelu, rozdzielczości, czasu trwania i akcji (szczególnie w przypadku wideo). Powyższa tabela przedstawia rzeczywiste wartości dla jednego zestawu parametrów, wyłącznie jako odniesienie co do rzędu wielkości.
- W przypadku interfejsów o stałej cenie (
exact) polemaxAmountRequiredw odpowiedzi 402 dla danego żądania jest kwotą należną za to żądanie (zgodną zcost.amountw odpowiedzi zakończonej powodzeniem, co zostało zweryfikowane w poprzedniej sekcji). - Każda cena jest uzyskiwana przez zaokrąglenie w dół
Credits × 0.095215do jednostki atomic (zobacz powyższą podstawę wyceny) i korzysta z tego samego przelicznika co czat. Ze względu na reprezentację zmiennoprzecinkową i zaokrąglanie niektóre wartości mogą różnić się od prostego iloczynu o 1 atomic ($0.000001); zawsze obowiązuje wartość zwrócona przez 402.
Cena płatności za zamówienie
Podczas opłacania zamówień w konsoli za pomocą X402 (zakup pakietu / doładowanie Credits) cena jest zgodna z wyświetlaną na stronie zamówienia, aamount z 402 stanowi ostateczną podstawę podpisu. Płatności za zamówienia korzystają z API platformy i wymagają tokena konta; szczegóły znajdują się w samouczku płatności za zamówienia.
Rzeczywisty przykład z samouczka płatności za zamówienia (zakup 10 Credits):
0.095215/Credit; płatność za zamówienie jest wyceniana według pakietu, a różnice między ceną utworzenia a ostateczną kwotą rozliczenia są zgodne z samouczkiem płatności za zamówienia.
Jak uzyskiwać ceny w czasie rzeczywistym
Ceny zmieniają się zależnie od modelu i parametrów, dlatego należy pobierać je programowo w czasie rzeczywistym, a nie kodować ich na stałe:- Cena za wywołanie: wyślij do docelowego API żądanie bez
PAYMENT-SIGNATURE(również bezAuthorization) i odczytaj zwrócone przez 402accepts[].maxAmountRequired. Ten krok nie powoduje naliczenia opłaty. Dla interfejsówexactjest to cena końcowa; dla interfejsówupto(czat) jest to limit górny, a faktyczne rozliczenie następuje według zużycia. - Cena czatu za token:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, odczytajpricing.input_usd/pricing.output_usddla każdego modelu (już obliczone wedługcredit_usd_rate). - Weryfikacja przeliczenia:
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(czyliUSDC ≈ Credits × 0.095215).
Podsumowanie
- Cena X402 = koszt Credits dla tego wywołania ×
0.095215, jest to ta sama cena co przy zwykłym rozliczaniu Credits, tylko rozliczana w USDC on-chain. 0.095215/Credit to najkorzystniejsza stawka platformy (dla dużych wolumenów) za Credits; przy małych doładowaniach jednostkowa cena zakupu Credits jest wyższa, więc X402 oznacza automatyczne uzyskanie najkorzystniejszej stawki.- W interfejsach
exact(obrazy / wideo / muzyka / wyszukiwanie / zamówienia) podpisana kwota jest kwotą należną za dane wywołanie; w interfejsachupto(czat) podpisywana jest wartość maksymalna, a rozliczenie odbywa się według rzeczywistego użycia. - Wiążącą ceną jest
maxAmountRequiredzwrócone przez 402: dlaexactjest to kwota do zapłaty (zgodna zcost.amountw pomyślnej odpowiedzi, co zostało przetestowane); dlauptojest to limit maksymalny, acost.amountw pomyślnej odpowiedzi jest rzeczywistą kwotą rozliczoną według użycia (≤ limitu maksymalnego).

