Conclusion essentielle
X402 n’est pas un système de tarification indépendant. Chaque appel d’API possède déjà un coût en Credits, qui constitue l’unique source de prix partagée par tous les modes de facturation (déduction de crédits par API Token, solde du compte, paiement on-chain X402). X402 ne fait que convertir ce coût en Credits en USDC on-chain selon un taux de change fixe :
1 Credit = 0.095215 USDC (soit 95215 atomic USDC, USDC ayant 6 décimales)
Autrement dit :
Base de tarification
La conversion est effectuée uniformément par la plateforme, et le montant est identique sur tous les réseaux pris en charge (Base, Solana) ; les différents réseaux ne diffèrent que par le contrat d’actif et le mode de signature, le prix est le même.
Relation avec le prix unitaire habituel des Credits
Les Credits de la plateforme sont vendus par paliers selon le principe « plus le volume est élevé, plus le prix unitaire est bas ». Lors de la facturation à l’appel, X402 utilise uniformément le prix unitaire du meilleur palier :
En d’autres termes, X402 règle chaque appel au prix unitaire des Credits du meilleur palier. Le prix unitaire des utilisateurs qui achètent des Credits avec des recharges de faible montant est plus élevé que celui de X402 ; seul le prix unitaire des utilisateurs effectuant de grandes recharges est identique à celui de X402.
Deux formes de prix : exact et upto
Dans la réponse 402 de X402, maxAmountRequired est le montant que vous devez signer. Il existe sous deux formes :
exact(prix fixe) : le prix peut être déterminé avant le traitement de la requête (images, vidéos, musique, recherche, paiement de commandes).maxAmountRequired = coût en Credits de cet appel × 0.095215, soit le montant dû pour cet appel (identique àcost.amountdans la réponse réussie).upto(mesure de l’utilisation après coup) : pour les interfaces telles que les complétions de chat, où « le nombre de tokens utilisés n’est connu qu’à la fin de la réponse ».maxAmountRequiredest un plafond (converti selon le plafond de crédits défini pour ce modèle : plafond de Credits × 0.095215), le règlement réel se fait selon l’utilisation réelle et ne dépasse pas ce plafond.
exact et upto. Seuls les prix sont abordés ci-dessous.
Prix de Chat (complétion de chat)
La complétion de chat utilise la mesureupto : elle est facturée selon l’utilisation réelle des tokens prompt / completion. Le prix par million (1M) de tokens = coût en Credits du modèle par 1M de tokens × 0.095215, ce qui est exactement identique au prix unitaire en USD affiché dans le catalogue public des modèles de la plateforme (/api/v1/models?with_pricing=true).
Le tableau suivant présente les prix réels (issus du catalogue de modèles, calculés selon le taux de change X402), en USD / 1M tokens :
Remarques :
- Le tableau présente les prix unitaires mesurés par token ; le coût d’une requête = tokens d’entrée × prix unitaire d’entrée + tokens de sortie × prix unitaire de sortie.
- Le plafond
uptoest le montant maximal autorisé à la signature pour une requête de ce modèle ; il ne correspond pas au montant réellement débité, et la grande majorité des requêtes reste bien en dessous du plafond. - Le plafond détermine uniquement « le montant maximal pouvant être débité » ; le règlement réel est calculé selon l’utilisation des tokens.
Exemple : le devis et le débit sont identiques (exact)
Voici un appel payant réel à serp/google effectué avec le X402Client officiel (Base exact). Il démontre la cohérence entre les trois éléments : le devis 402, le montant signé et le cost renvoyé dans la réponse réussie.
cost.amount renvoyé (0.000952 USDC) est entièrement cohérent avec le devis 402, et avec Credits × 0.095215. Le champ settlement est le statut de règlement de ce paiement (authorized = autorisé) ; le règlement on-chain est traité par la plateforme, voir le mécanisme des schémas de facturation exact et upto.
Calcul du devis upto (chat)
Le chat est mesuré en tokens. Le devis d’une requête (et non le plafond) est calculé selon la formule suivante (en prenant gpt-4o-mini comme exemple) :
upto (pour gpt-4o-mini, 1 Credit = 95215 atomic), ce qui indique seulement le montant maximal susceptible d’être débité ; le devis réel de cette requête (environ $0.0001 dans l’exemple ci-dessus) est bien inférieur au plafond et est réglé selon l’utilisation en tokens. Voir le mécanisme de règlement on-chain de upto dans les schémas de facturation exact et upto.
Prix des autres services (exact à prix fixe)
Le prix des interfaces telles que les images, vidéos, musiques et recherches peut être déterminé lors de la requête, elles utilisent donc exact. Le tableau ci-dessous présente les prix réels, obtenus à partir du maxAmountRequired 402 renvoyé par les interfaces en ligne pour des requêtes non payées (la consultation d’un devis n’entraîne aucun débit) :
Remarques :
- Le prix d’un même service varie selon le modèle, la résolution, la durée et les actions (en particulier pour les vidéos). Le tableau ci-dessus présente des valeurs réelles pour un ensemble donné de paramètres, uniquement à titre indicatif d’ordre de grandeur.
- Pour ce type d’interface à prix fixe (
exact), lemaxAmountRequireddans la réponse 402 de cette requête correspond au montant dû pour cette requête (cohérent avec lecost.amountde la réponse réussie, déjà vérifié dans la section précédente). - Chaque prix est obtenu en arrondissant à l’inférieur en unités atomic
Credits × 0.095215(voir la base tarifaire ci-dessus), avec le même taux de conversion que celui utilisé pour le chat. En raison de la représentation en virgule flottante et de l’arrondi, certaines valeurs peuvent différer de 1 atomic ($0.000001) du produit naïf ; la valeur renvoyée par 402 prévaut systématiquement.
Prix des paiements de commande
Lors du paiement de commandes du tableau de bord avec X402 (achat de forfaits / recharge de Credits), le prix affiché sur la page de commande prévaut, et leamount de 402 constitue la base finale de signature. Le paiement de commande passe par l’API de la plateforme et nécessite un jeton de compte, voir le tutoriel de paiement de commande.
Un exemple réel du tutoriel de paiement de commande (achat de 10 Credits) :
0.095215/Credit ; le paiement de commande suit la tarification des forfaits, et la différence entre son prix de création et son montant final de règlement est soumise au tutoriel de paiement de commande.
Comment obtenir les prix en temps réel
Les prix varient selon les modèles et les paramètres ; veuillez les obtenir en temps réel par programme, sans les coder en dur :- Prix à l’utilisation : envoyez une requête à l’API cible sans
PAYMENT-SIGNATURE(et sansAuthorization), puis lisez leaccepts[].maxAmountRequired402 renvoyé. Cette étape n’entraîne aucun débit. Pour les interfacesexact, il s’agit du prix final ; pour les interfacesupto(chat), il s’agit du plafond, le règlement réel étant effectué selon l’utilisation. - Prix du chat par token :
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, lisezpricing.input_usd/pricing.output_usdde chaque modèle (déjà calculés seloncredit_usd_rate). - Vérification de conversion :
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(c’est-à-direUSDC ≈ Credits × 0.095215).
Résumé
- Prix X402 = le coût en Credits de cet appel ×
0.095215, c’est le même prix que la facturation normale en Credits, mais réglé en USDC on-chain. 0.095215/Credit est le prix unitaire des Credits au meilleur palier (volume élevé) de la plateforme ; les petites recharges achètent les Credits à un prix unitaire plus élevé, donc X402 équivaut à obtenir automatiquement le meilleur prix unitaire.- Le montant signé pour les interfaces
exact(images / vidéos / musique / recherche / commandes) est le montant à payer pour cet appel ; les interfacesupto(chat) signent le plafond et règlent selon l’utilisation réelle. - Le prix faisant autorité est basé sur le
maxAmountRequiredretourné par 402 : pourexact, il s’agit du montant à payer (identique aucost.amountde la réponse réussie, testé) ; pourupto, il s’agit du plafond, et seul lecost.amountde la réponse réussie est le montant réel réglé selon l’utilisation (≤ plafond).

