Przejdź do głównej treści
Ace Data Cloud X402 obecnie używa dwóch typów scheme: exact i upto. Rozwiązują one różne problemy rozliczeniowe.

exact

exact oznacza, że cena tego żądania może zostać określona przed wejściem do docelowego API. Kwota podpisana przez klienta jest ostateczną kwotą obciążenia. Odpowiednie dla:
  • generowania obrazów o stałej cenie;
  • tworzenia zadań wideo o stałej cenie;
  • API wyszukiwania lub narzędzi o stałej cenie;
  • płatności za zamówienia.
EVM exact używa USDC EIP-3009 TransferWithAuthorization:
Facilitator na etapie /verify weryfikuje podpis i kwotę, a na etapie /settle przesyła to upoważnienie do łańcucha.

upto

upto oznacza, że klient autoryzuje maksymalny limit, a Ace Data Cloud rozlicza się według rzeczywistego użycia po zakończeniu żądania; rzeczywista kwota obciążenia nie może przekroczyć limitu. Odpowiednie dla:
  • uzupełniania czatu: ostateczna cena zależy od prompt tokens i completion tokens;
  • odpowiedzi strumieniowych: rzeczywista długość wyjścia jest znana dopiero po zakończeniu;
  • przyszłych API z rozliczaniem po fakcie.
upto używa Permit2 PermitWitnessTransferFrom. Klient podpisuje nie stały transfer, lecz autoryzację limitu z witness:
permitted.amount jest limitem, niekoniecznie ostateczną kwotą obciążenia. Gateway na etapie /record przekształca rzeczywiste użycie na amount i przekazuje je do Facilitatora. Facilitator zezwala tylko na rozliczenie amount <= permitted.amount. Wynik działania programu Base upto:
Wyjaśnienie:
  • Limit autoryzacji zwrócony w 402 wynosi 95215 atomic USDC, klient podpisuje zgodnie z tym limitem.
  • Po rzeczywistej odpowiedzi modelu rozliczane jest tylko 3 atomic USDC, a transakcję on-chain można sprawdzić na BaseScan.
  • Ten wynik pokazuje kluczową różnicę upto: podpisana kwota jest limitem, a settlement on-chain może być niższy niż limit.
  • Jeśli rzeczywiste użycie przekroczy limit, Facilitator powinien odrzucić settlement, a klient musi ponownie autoryzować wyższy limit.
upto jest obecnie dostępne tylko na Base. Gdy wymagane jest rozliczanie po fakcie, używaj Base.

Dlaczego potrzebne jest approve Permit2

upto ostatecznie pobiera USDC z portfela płatnika przez x402 proxy za pośrednictwem Permit2. Przed pierwszym użyciem portfel płatnika musi jednorazowo przyznać Permit2 ERC-20 allowance. Python CLI:
Programowo:
Po zakończeniu autoryzacji każde żądanie nadal wymaga podpisania nowej koperty upto, ponieważ nonce, deadline, witness i limit kwoty są różne.

Rozliczenie zerowej kwoty

upto obsługuje przypadek, gdy rzeczywista kwota wynosi 0. Na przykład docelowe API nie wygenerowało pomyślnie rozliczalnego użycia, wtedy Gateway może przekazać amount = "0". Facilitator zwróci sukces, ale nie wyśle transakcji on-chain. Pozwala to uniknąć problemu „żądanie nie zakończyło się sukcesem, ale nadal pobierana jest opłata on-chain”.

Zalecenia dotyczące wyboru

Jeśli nie masz pewności, który wybrać, najpierw użyj domyślnego zachowania SDK; SDK wybierze wymaganie płatności dla pasującej sieci zwrócone przez serwer.

Lista kontrolna Base upto

Podczas integracji lub diagnozowania problemów potwierdź, że poniższe parametry pochodzą z tej samej odpowiedzi 402 i pozostają zgodne podczas podpisywania przez klienta: Typowe błędy i sposoby obsługi: