> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # X402 Explication des prix > Platform API guide - Ace Data Cloud Ce document explique comment le prix est déterminé lors de l'appel de l'API Ace Data Cloud avec X402, ainsi que la relation entre ce prix et le prix des **Credits** (crédits) ordinaires de la plateforme. ## Conclusion clé X402 n'est pas un système de prix indépendant. Chaque appel API a déjà un coût en **Credits**, qui est la seule source de prix commune à tous les modes de facturation (découpage de crédits par API Token, solde de compte, paiement en chaîne avec X402). X402 convertit simplement ce coût en Credits en USDC en utilisant un taux de change fixe : > **1 Credit = 0.095215 USDC** (c'est-à-dire `95215` atomic USDC, USDC à 6 décimales) En d'autres termes : ```text theme={null} Prix X402 (USDC) = Coût en Credits de cet appel × 0.095215 ``` Ce taux de change n'est pas fixé au hasard, il est égal au **prix unitaire des Credits en gros (meilleure offre)** de la plateforme. Ainsi, payer avec X402 ≈ acheter des Credits au meilleur prix unitaire et consommer, **sans prime X402**, et vous bénéficiez directement du prix le plus bas des Credits, sans prépaiement ni API Token. ## Base de tarification | Élément | Valeur | Description | | - | - | - | | Taux de change | `1 Credit = 0.095215 USDC` | Taux de change fixe défini par la plateforme | | Unité atomic | `1 Credit = 95215 atomic USDC` | USDC à 6 décimales, `atomic = floor(credits × 0.095215 × 1e6)` | | Coût minimum | `1 atomic USDC` (0,000001 \$) | Même si le coût est très bas, au moins 1 atomic sera facturé | | Devise de tarification | USDC | Base / SKALE est ERC-20 USDC, Solana est SPL USDC | La conversion est effectuée uniformément par la plateforme, le montant est identique pour tous les réseaux pris en charge (Base, SKALE, Solana) ; les différents réseaux n'ont que des contrats d'actifs et des méthodes de signature différents, le prix reste le même. ### Relation avec le prix unitaire des Credits ordinaires Les Credits de la plateforme sont vendus selon un système échelonné « plus la consommation est élevée, plus le prix unitaire est bas ». Lors de la facturation par appel X402, le prix unitaire optimal de l'échelon est utilisé : | Mode d'achat/paiement | Prix unitaire des Credits approximatif | Description | | - | - | - | | Entrée / Petit recharge | Environ `$0.13 / Credit` | Prix de liste, prix unitaire lors de l'achat de petits crédits | | Gros / Meilleure offre | `$0.095215 / Credit` | Prix unitaire le plus bas | | **X402 paiement par appel** | **`$0.095215 / Credit`** | **Égal au prix unitaire optimal** | En d'autres termes, X402 règle chaque appel au prix unitaire optimal des Credits. Les utilisateurs qui achètent des Credits avec un petit recharge paieront un prix unitaire plus élevé que X402 ; seuls les utilisateurs qui rechargent en gros auront un prix unitaire 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 deux formes : * **`exact` (prix fixe)** : Le prix peut être déterminé avant le traitement de la demande (images, vidéos, musique, recherche, paiement de commande). `maxAmountRequired = Coût en Credits de cet appel × 0.095215`, c'est-à-dire le montant à payer pour cet appel (identique à `cost.amount` dans la réponse réussie). * **`upto` (mesure post-consommation)** : Interfaces comme le complément de chat où « on ne sait combien de tokens ont été utilisés qu'à la fin de la réponse ». `maxAmountRequired` est un **plafond** (converti selon le plafond défini par ce modèle : Plafond Credits × 0.095215), le règlement se fait en fonction de la consommation réelle, sans dépasser le plafond. Pour les détails des protocoles concernant ces deux schémas, voir [`exact` et `upto` plans de facturation](https://platform.acedata.cloud/documents/x402-metered-upto). Ci-dessous, nous ne parlons que des prix. ## Prix du Chat (complément de chat) Le complément de chat est mesuré en `upto` : facturé selon la consommation réelle de tokens de prompt / completion. Le prix par million (1M) de tokens = `Coût en Credits de ce modèle par 1M de tokens × 0.095215`, totalement conforme au prix en USD affiché dans le répertoire public des modèles de la plateforme (`/api/v1/models?with_pricing=true`). Le tableau ci-dessous présente les prix réels (extraits du répertoire des modèles, selon le taux de change X402), unité USD / 1M token : | Modèle | Entrée / 1M | Sortie / 1M | Plafond `upto` | | - | - | - | - | | gpt-4o-mini | 0,0796 \$ | 0,3183 \$ | 1 Credit (0,095215 \$) | | gemini-2.5-flash | 0,1591 \$ | 1,3262 \$ | 5 Credits (0,476074 \$) | | gpt-5 / gpt-5.1 | 0,6631 \$ | 5,3050 \$ | 20 Credits (1,904299 \$) | | gemini-2.5-pro | 0,6631 \$ | 5,3050 \$ | 50 Credits (4,760750 \$) | | gpt-4.1 | 1,0610 \$ | 4,2440 \$ | 20 Credits (1,904299 \$) | | claude-sonnet-4-5 | 0,6006 \$ | 3,0028 \$ | 50 Credits (4,760750 \$) | | grok-4 | 1,5915 \$ | 7,9574 \$ | 10 Credits (0,952149 \$) | | claude-opus-4-1 | 3,0028 \$ | 15,0140 \$ | 50 Credits (4,760750 \$) | Remarques : * Le tableau présente le prix unitaire mesuré par token ; le coût d'une demande = Entrée token × Prix unitaire d'entrée + Sortie token × Prix unitaire de sortie. * Le plafond `upto` est le montant maximum autorisé à signer pour une demande de ce modèle ; ce n'est pas le montant réellement facturé, la grande majorité des demandes sont bien en dessous du plafond. * Le plafond ne détermine que « le montant maximum qui pourrait être facturé », le règlement réel est calculé en fonction de la consommation de tokens. ### Exemple : Prix et facturation identiques (`exact`) Voici un appel de **paiement réel** effectué avec le client officiel X402Client sur `serp/google` (Base `exact`). Il démontre la cohérence des trois éléments : prix 402, montant signé, et `cost` retourné dans la réponse réussie. ```text theme={null} # 1) Demande non payée -> 402, obtention du prix (pas de frais) POST /serp/google -> 402 base/exact maxAmountRequired = 952 atomic = 0,000952 $ = 0,01 Credit # 0,01 × 0,095215 = 0,00095215, arrondi à l'atomique = 952 # 2) Signature du paiement de 952 atomic avec le portefeuille, réessayer POST /serp/google (PAYMENT-SIGNATURE) -> 200 body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"} ``` 响应 retourné `cost.amount` (0.000952 USDC) est entièrement cohérent avec le devis 402 et avec `Credits × 0.095215`. Le champ `settlement` est l'état de règlement de ce paiement (`authorized` = autorisé) ; le règlement sur la chaîne est géré par la plateforme, le mécanisme est décrit dans les [schémas de facturation `exact` et `upto`](https://platform.acedata.cloud/documents/x402-metered-upto). ### Calcul du devis `upto` (chat) Le chat est mesuré par token. Le devis pour une demande donnée (pas un plafond) est calculé selon la formule suivante (à titre d'exemple avec gpt-4o-mini) : ```text theme={null} Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens) USDC = Credits × 0.095215 ``` Une demande de 500 tokens de prompt + 200 tokens de completion : ```text theme={null} Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits Devis USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034 ``` Le client signe selon le plafond `upto` (gpt-4o-mini est 1 Credit = `95215` atomic), ce n'est que **le montant maximum qui pourrait être débité** ; le devis réel pour cette demande (environ \$0.0001 dans l'exemple ci-dessus) est bien inférieur au plafond, réglé selon l'utilisation des tokens. Le mécanisme de règlement sur la chaîne pour `upto` est décrit dans les [schémas de facturation `exact` et `upto`](https://platform.acedata.cloud/documents/x402-metered-upto). ## Autres prix de services (prix fixe `exact`) Les interfaces pour des images, vidéos, musique, recherche peuvent déterminer le prix au moment de la demande, en utilisant `exact`. Le tableau ci-dessous présente les prix réels, extraits des réponses 402 `maxAmountRequired` pour les demandes non payées (la consultation des devis ne génère pas de frais) : | Service | Modèle / Paramètres d'exemple | Credits | USDC | atomic | | - | - | - | - | - | | Recherche web | serp/google, ≤10 résultats | 0.01 | \$0.000952 | 952 | | Image | nano-banana | 0.14 | \$0.013330 | 13330 | | Image | gpt-image-1, 1024×1024 | 0.20 | \$0.019043 | 19043 | | Image | flux-dev | 0.24 | \$0.022851 | 22851 | | Image | midjourney imagine | 0.27 | \$0.025708 | 25708 | | Image | seedream-4 | 0.32 | \$0.030468 | 30468 | | Musique | suno generate | 0.55 | \$0.052368 | 52368 | | Musique | producer generate | 0.68 | \$0.064746 | 64746 | | Vidéo | luma | 1.19 | \$0.113305 | 113305 | | Vidéo | hailuo (minimax-hailuo-2-3) | 1.72 | \$0.163769 | 163769 | | Vidéo | kling-v2-6 std | 2.10 | \$0.199951 | 199951 | | Vidéo | kling-v3 std | 4.20 | \$0.399903 | 399903 | | Vidéo | veo-3 text→video | 5.00 | \$0.476074 | 476074 | | Vidéo | seedance-1-0-pro, 1080p / 5s | 5.60 | \$0.533204 | 533204 | | Vidéo | wan2.6-t2v | 13.50 | \$1.285402 | 1285402 | Remarques : * Le prix d'un même service varie selon le **modèle, la résolution, la durée, l'action** (surtout pour les vidéos). Le tableau ci-dessus présente les valeurs réelles pour un ensemble de paramètres, à titre de référence. * Pour ces interfaces à prix fixe (`exact`), le `maxAmountRequired` dans la réponse 402 correspond au montant à payer pour cette demande (cohérent avec le `cost.amount` de la réponse réussie, déjà mesuré dans la section précédente). * Chaque prix est arrondi à l'unité atomic à partir de `Credits × 0.095215` (voir la référence de tarification ci-dessus), utilisant le même système de conversion que pour le chat. En raison de la représentation flottante et de l'arrondi, certaines valeurs peuvent différer de 1 atomic (\$0.000001) par rapport au produit brut, et toutes doivent être considérées selon la valeur retournée par 402. ## Prix de paiement des commandes Lors du paiement des commandes via la console de paiement X402 (achat de forfaits / recharge de Credits), le prix affiché sur la page de commande fait foi, le `amount` de 402 étant la base finale de la signature. Le paiement des commandes passe par l'API de la plateforme, nécessitant un jeton de compte, voir [tutoriel de paiement de commande](https://platform.acedata.cloud/documents/x402-order-payment). Un exemple réel dans le tutoriel de paiement de commande (achat de 10 Credits) : ```text theme={null} description Ace Data Cloud Credits x 10.0 created price 1.26 # Prix de création de la commande (USD) settled 1.20 USDC # Montant final de la signature/règlement (= 402 amount) = 1200000 atomic USDC ``` Remarque : **paiement à l'appel** (voir ci-dessus Chat / autres services) et **paiement de commande** sont deux voies différentes. Le paiement à l'appel utilise uniformément le tarif unitaire optimal de `0.095215`/Credit ; le paiement de commande est basé sur le prix du forfait, la différence entre le prix de création et le montant final de règlement est précisée dans le [tutoriel de paiement de commande](https://platform.acedata.cloud/documents/x402-order-payment). ## Comment obtenir les prix en temps réel Les prix varient selon le modèle et les paramètres, veuillez obtenir les prix en temps réel par programme, ne pas les coder en dur : * **Prix à l'appel** : Envoyez une demande à l'API cible **sans** `PAYMENT-SIGNATURE` (ni `Authorization`), lisez le `accepts[].maxAmountRequired` retourné dans la réponse 402. Cette étape ne générera pas de frais. Pour l'interface `exact`, c'est le prix final ; pour l'interface `upto` (chat), c'est le plafond, le règlement se fait selon l'utilisation. * **Prix par token pour le chat** : `GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat`, lisez `pricing.input_usd` / `pricing.output_usd` pour chaque modèle (déjà calculé selon `credit_usd_rate`). * **Vérification de conversion** : `atomic = floor(Credits × 0.095215 × 1e6)`, `USDC = atomic / 1e6` (c'est-à-dire `USDC ≈ Credits × 0.095215`). Exemple de demande minimale pour obtenir le prix : ```bash theme={null} curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \ -H 'Content-Type: application/json' \ -d '{"prompt": "a cat"}' # Retourne 402, accepts[].maxAmountRequired est le prix de cet appel (exact) ``` ## Résumé * X402 prix = Coût en crédits de cet appel × `0.095215`, et le tarif des crédits ordinaires est **le même prix**, juste réglé en USDC sur la chaîne. * `0.095215`/Crédit est le **meilleur tarif** (gros montants) pour les crédits ; les petits recharges achètent des crédits à un prix unitaire plus élevé, donc X402 équivaut à obtenir automatiquement le meilleur prix unitaire. * Le montant signé de l'interface `exact` (image / vidéo / musique / recherche / commande) est le montant à payer ; l'interface `upto` (chat) signe le plafond, réglé selon l'utilisation réelle. * Le prix de référence est basé sur `maxAmountRequired` retourné par 402 : `exact` est le montant à payer (cohérent avec `cost.amount` de la réponse réussie, testé en pratique) ; `upto` est le plafond, le `cost.amount` de la réponse réussie est le montant réel réglé selon l'utilisation (≤ plafond). ## Documents connexes | Document | Lien | | - | - | | Guide d'intégration X402 (aperçu) | [Guide d'intégration X402](https://platform.acedata.cloud/documents/x402-integration) | | Démarrage rapide | [Démarrage rapide X402](https://platform.acedata.cloud/documents/x402-quickstart) | | Plans de tarification `exact` et `upto` | [Description des plans de tarification](https://platform.acedata.cloud/documents/x402-metered-upto) | | Réseaux et méthodes de paiement | [Réseaux et méthodes de paiement](https://platform.acedata.cloud/documents/x402-networks) | | Tutoriel de paiement de commande | [Tutoriel de paiement de commande](https://platform.acedata.cloud/documents/x402-order-payment) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.