exact und upto. Sie lösen unterschiedliche Abrechnungsprobleme.
exact
exact bedeutet, dass der Preis dieser Anfrage bereits vor dem Eintritt in die Ziel-API bestimmt werden kann. Der vom Client signierte Betrag ist der endgültig abgebuchte Betrag.
Geeignet für:
- Bildgenerierung mit festem Preis;
- Erstellung von Videoaufgaben mit festem Preis;
- Such- oder Tool-APIs mit festem Preis;
- Bestellzahlungen.
exact verwendet USDC EIP-3009 TransferWithAuthorization:
/verify und übermittelt diese Autorisierung in der Phase /settle an die Blockchain.
upto
upto bedeutet, dass der Client eine maximale Obergrenze autorisiert und Ace Data Cloud nach Abschluss der Anfrage entsprechend der tatsächlichen Nutzung abrechnet; die tatsächliche Abbuchung darf die Obergrenze nicht überschreiten.
Geeignet für:
- Chat-Vervollständigungen: Der endgültige Preis hängt von Prompt-Tokens und Completion-Tokens ab;
- Streaming-Antworten: Die tatsächliche Ausgabelänge ist erst nach dem Ende bekannt;
- zukünftige APIs mit nachgelagerter Messung.
upto verwendet Permit2 PermitWitnessTransferFrom. Der Client signiert keine feste Überweisung, sondern eine Obergrenzenautorisierung mit Witness:
permitted.amount ist die Obergrenze und nicht unbedingt die endgültige Abbuchung. Das Gateway wandelt die tatsächliche Nutzung in der Phase /record in amount um und übergibt sie an den Facilitator. Der Facilitator erlaubt nur eine Abrechnung mit amount <= permitted.amount.
Das Programmausführungsergebnis von Base upto:
- Die in 402 zurückgegebene Autorisierungsobergrenze beträgt
95215atomic USDC, der Client signiert entsprechend dieser Obergrenze. - Nach der tatsächlichen Modellantwort werden nur
3atomic USDC abgerechnet; die On-Chain-Transaktion ist auf BaseScan einsehbar. - Dieses Ergebnis zeigt den entscheidenden Unterschied von
upto: Der signierte Betrag ist eine Obergrenze, die On-Chain-Abrechnung kann unter der Obergrenze liegen. - Wenn die tatsächliche Nutzung die Obergrenze überschreitet, sollte der Facilitator die Abrechnung ablehnen, und der Client muss erneut mit einer höheren Obergrenze autorisieren.
upto wird derzeit nur auf Base angeboten. Wenn eine nachgelagerte Messung erforderlich ist, verwenden Sie bitte Base.
Warum Permit2 approve erforderlich ist
upto zieht USDC letztendlich über den x402-Proxy mittels Permit2 aus der Zahlungswallet ein. Vor der ersten Nutzung muss die Zahlungswallet Permit2 einmalig eine ERC-20-Allowance erteilen.
Python-CLI:
upto-Envelope signieren, da Nonce, Deadline, Witness und die Betragsobergrenze unterschiedlich sind.
Abrechnung mit Nullbetrag
upto unterstützt Fälle, in denen der tatsächliche Betrag 0 ist. Wenn beispielsweise die Ziel-API keine erfolgreich abrechenbare Nutzung erzeugt hat, kann das Gateway amount = "0" übergeben. Der Facilitator gibt Erfolg zurück, sendet jedoch keine On-Chain-Transaktion.
Dies kann das Problem vermeiden, dass „die Anfrage nicht erfolgreich war, aber dennoch On-Chain-Gebühren abgebucht werden“.
Auswahlvorschläge
Wenn Sie nicht sicher sind, welches Sie wählen sollen, verwenden Sie zuerst das SDK-Standardverhalten; das SDK wählt die passende Netzwerk-Payment-Requirement aus, die der Server zurückgibt.
Base-upto-Checkliste
Bei der Integration oder Fehlerbehebung bestätigen Sie bitte, dass die folgenden Parameter aus derselben 402-Antwort stammen und beim Signieren durch den Client konsistent bleiben:
Häufige Fehler und Behandlungsmethoden:

