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.
exact używa USDC EIP-3009 TransferWithAuthorization:
/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:
- Limit autoryzacji zwrócony w 402 wynosi
95215atomic USDC, klient podpisuje zgodnie z tym limitem. - Po rzeczywistej odpowiedzi modelu rozliczane jest tylko
3atomic 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:
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:

