Przejdź do głównej treści
Ten dokument wyjaśnia, jak ustalana jest cena podczas wywoływania Ace Data Cloud API za pomocą X402 oraz jaki ma ona związek ze zwykłą ceną platformowych Credits (limitów).

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:
Ten kurs nie został ustalony arbitralnie; jest równy najlepszej stawce (dla dużych wolumenów) Credits na platformie. Dlatego płatność przez X402 ≈ zakup Credits po najlepszej stawce, a następnie ich wykorzystanie, bez narzutu X402; zamiast tego od razu korzystasz z najniższej ceny Credits, bez konieczności wcześniejszego doładowania i bez API Token.

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 z cost.amount w 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”. maxAmountRequired jest 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.
Szczegóły protokołu dotyczące tych dwóch schematów znajdują się w schematach rozliczeń exact i upto. Poniżej omawiane są wyłącznie ceny.

Ceny Chat (uzupełnianie czatu)

Uzupełnianie czatu jest mierzone w trybie upto: 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 upto to 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.
Zwrócone w 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):
Żądanie z 500 tokenami prompt + 200 tokenami completion:
Klient podpisuje limit 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) pole maxAmountRequired w odpowiedzi 402 dla danego żądania jest kwotą należną za to żądanie (zgodną z cost.amount w odpowiedzi zakończonej powodzeniem, co zostało zweryfikowane w poprzedniej sekcji).
  • Każda cena jest uzyskiwana przez zaokrąglenie w dół Credits × 0.095215 do 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, a amount 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):
Uwaga: płatność za wywołanie (powyższy Chat / inne usługi) i płatność za zamówienie to dwie różne ścieżki. Płatność za wywołanie jednolicie korzysta z najkorzystniejszej stawki 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ż bez Authorization) i odczytaj zwrócone przez 402 accepts[].maxAmountRequired. Ten krok nie powoduje naliczenia opłaty. Dla interfejsów exact jest to cena końcowa; dla interfejsów upto (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, odczytaj pricing.input_usd / pricing.output_usd dla każdego modelu (już obliczone według credit_usd_rate).
  • Weryfikacja przeliczenia: atomic = floor(Credits × 0.095215 × 1e6), USDC = atomic / 1e6 (czyli USDC ≈ Credits × 0.095215).
Minimalny przykład żądania pobierającego cenę:

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 interfejsach upto (czat) podpisywana jest wartość maksymalna, a rozliczenie odbywa się według rzeczywistego użycia.
  • Wiążącą ceną jest maxAmountRequired zwrócone przez 402: dla exact jest to kwota do zapłaty (zgodna z cost.amount w pomyślnej odpowiedzi, co zostało przetestowane); dla upto jest to limit maksymalny, a cost.amount w pomyślnej odpowiedzi jest rzeczywistą kwotą rozliczoną według użycia (≤ limitu maksymalnego).

Powiązana dokumentacja