exact och upto. De löser olika debiteringsproblem.
exact
exact innebär att priset för denna begäran kan fastställas innan den går in i mål-API:t. Beloppet som klienten signerar är det slutliga debiteringsbeloppet.
Lämpligt för:
- Bildgenerering med fast pris;
- Skapande av videouppgifter med fast pris;
- Sök- eller verktygs-API:er med fast pris;
- Orderbetalning.
exact använder USDC EIP-3009 TransferWithAuthorization:
/verify-fasen och skickar denna auktorisering till kedjan i /settle-fasen.
upto
upto innebär att klienten auktoriserar en maximal gräns, och Ace Data Cloud avräknar enligt faktisk användning efter att begäran har slutförts; den faktiska debiteringen får inte överstiga gränsen.
Lämpligt för:
- Chattkomplettering: slutpriset beror på prompt tokens och completion tokens;
- Strömmande svar: den verkliga utdata-längden är känd först när den avslutas;
- Framtida API:er med efterhandsmätning.
upto använder Permit2 PermitWitnessTransferFrom. Det klienten signerar är inte en fast överföring, utan en gränsauktorisering med witness:
permitted.amount är gränsen, och är inte nödvändigtvis den slutliga debiteringen. Gateway konverterar den faktiska användningen till amount och skickar den till Facilitator i /record-fasen. Facilitator tillåter endast avräkning när amount <= permitted.amount.
Programkörningsresultatet för Base upto:
- Auktoriseringsgränsen som returneras i 402 är
95215atomic USDC, och klienten signerar enligt denna gräns. - Efter det faktiska modellsvar avräknas endast
3atomic USDC, och kedjetransaktionen kan redan kontrolleras på BaseScan. - Detta resultat visar den viktigaste skillnaden för
upto: det signerade beloppet är en gräns, och settlement på kedjan kan vara mindre än gränsen. - Om den faktiska användningen överstiger gränsen ska Facilitator neka settlement, och klienten behöver auktorisera igen enligt en högre gräns.
upto erbjuds för närvarande endast på Base. När efterhandsmätning krävs, använd Base.
Varför Permit2 approve behövs
upto hämtar slutligen USDC från betalningsplånboken via Permit2 genom x402 proxy. Före första användningen behöver betalningsplånboken ge Permit2 en ERC-20 allowance en gång.
Python CLI:
upto envelope, eftersom nonce, deadline, witness och beloppsgräns är olika.
Avräkning med nollbelopp
upto stöder situationer där det faktiska beloppet är 0. Om mål-API:t till exempel inte lyckas producera debiterbar användning kan Gateway skicka in amount = "0". Facilitator returnerar framgång, men skickar ingen kedjetransaktion.
Detta kan undvika problemet med ”begäran lyckades inte men avgifter på kedjan debiteras ändå”.
Rekommendationer för val
Om du är osäker på vilket du ska välja, använd först SDK:ns standardbeteende; SDK:t väljer det matchande nätverkets payment requirement som servern returnerar.
Checklista för Base upto
Vid integration eller felsökning, bekräfta att följande parametrar kommer från samma 402-svar och håll dem konsekventa vid klientsignering:
Vanliga fel och hanteringssätt:

