exact et upto. Ils résolvent des problèmes de facturation différents.
exact
exact indique que le prix de cette requête peut être déterminé avant son entrée dans l’API cible. Le montant signé par le client est le montant final débité.
Convient pour :
- la génération d’images à prix fixe ;
- la création de tâches vidéo à prix fixe ;
- les API de recherche ou d’outils à prix fixe ;
- le paiement de commandes.
exact utilise USDC EIP-3009 TransferWithAuthorization :
/verify, puis soumet cette autorisation on-chain à l’étape /settle.
upto
upto indique que le client autorise un plafond maximal ; Ace Data Cloud règle selon l’utilisation réelle après la fin de la requête, et le montant réellement débité ne peut pas dépasser le plafond.
Convient pour :
- les complétions de chat : le prix final dépend des tokens du prompt et des tokens de complétion ;
- les réponses en streaming : la longueur réelle de sortie n’est connue qu’à la fin ;
- les futures API de mesure a posteriori.
upto utilise Permit2 PermitWitnessTransferFrom. Ce que le client signe n’est pas un transfert fixe, mais une autorisation de plafond avec witness :
permitted.amount est le plafond, et n’est pas nécessairement le montant final débité. Le Gateway convertit l’utilisation réelle en amount à l’étape /record et le transmet au Facilitator. Le Facilitator autorise uniquement le règlement lorsque amount <= permitted.amount.
Résultat d’exécution du programme Base upto :
- Le plafond d’autorisation renvoyé dans le 402 est de
95215atomic USDC, et le client signe selon ce plafond. - Après la réponse effective du modèle, seuls
3atomic USDC sont réglés ; la transaction on-chain peut être consultée sur BaseScan. - Ce résultat démontre la différence clé de
upto: le montant signé est un plafond, et le settlement on-chain peut être inférieur au plafond. - Si l’utilisation réelle dépasse le plafond, le Facilitator doit refuser le settlement, et le client doit réautoriser selon un plafond plus élevé.
upto est actuellement fourni uniquement sur Base. Lorsque vous avez besoin d’une mesure a posteriori, veuillez utiliser Base.
Pourquoi un approve Permit2 est nécessaire
upto récupère finalement les USDC depuis le portefeuille payeur via Permit2 par l’intermédiaire du proxy x402. Avant la première utilisation, le portefeuille payeur doit accorder une allowance ERC-20 unique à Permit2.
CLI Python :
upto, car le nonce, la deadline, le witness et le plafond du montant sont tous différents.
Règlement à montant zéro
upto prend en charge les cas où le montant réel est de 0. Par exemple, si l’API cible ne produit pas avec succès une utilisation facturable, le Gateway peut transmettre amount = "0". Le Facilitator renverra un succès, mais n’émettra pas de transaction on-chain.
Cela permet d’éviter le problème consistant à « payer des frais on-chain alors que la requête n’a pas réussi ».
Recommandations de choix
Si vous ne savez pas lequel choisir, utilisez d’abord le comportement par défaut du SDK ; le SDK sélectionnera la payment requirement du réseau correspondant renvoyée par le serveur.
Liste de vérification Base upto
Lors de l’intégration ou du dépannage, veuillez confirmer que les paramètres suivants proviennent de la même réponse 402 et restent cohérents lors de la signature côté client :
Erreurs courantes et méthodes de traitement :

