X402 Explication des prix

​

Conclusion clé

1 Credit = 0.095215 USDC (c’est-à-dire 95215 atomic USDC, USDC à 6 décimales)

Prix X402 (USDC) = Coût en Credits de cet appel × 0.095215

​

Base de tarification

​

Relation avec le prix unitaire des Credits ordinaires

​

Deux formes de prix : exact et upto

• 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.

​

Prix du Chat (complément de chat)

• 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)

# 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"}

​

Calcul du devis upto (chat)

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
Devis USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

​

Autres prix de services (prix fixe exact)

• 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

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

​

Comment obtenir les prix en temps réel

• 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).

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