L’API se paie à l’usage, sans abonnement. Chaque workspace a un porte-monnaie API, compté en crédits et rechargé en euros. Chaque requête puise dans le solde du workspace de la clé qui l’envoie.
Crédits et eurosLien vers la section Crédits et euros
- L’API compte en crédits : les prix de
GET /, le solde dev1/ models GET /et le coût de chaque requête sont en crédits.v1/ credits - Le portail affiche tout en euros : l’onglet « Modèles » donne les prix en euros, et le formulaire « Recharger » indique combien de crédits vous recevez pour un montant (« Vous recevez »).
- Le prix d’un modèle suit celui de son fournisseur, avec la marge de Moon AI. Il peut changer avec lui : lisez-le dans
/v1/modelsplutôt que de le garder en dur.
SoldeLien vers la section Solde
Le solde du porte-monnaie se lit dans l’onglet « Aperçu » du portail, ou par l’API avec GET / (référence : Lire le solde). Il comprend les crédits payés, les crédits offerts et le crédit API inclus dans le forfait, et déduit déjà la réserve des requêtes en cours.
Coût d’une requêteLien vers la section Coût d’une requête
Chaque réponse porte l’en-tête X-Moon-Request-Id, l’identifiant de la requête (gen- suivi de 32 caractères). Le coût apparaît à trois endroits :
- dans la réponse des médias :
usage.credits(images, embeddings, transcription, OCR, vidéo terminée) ou l’en-têteX-Moon-Credits(voix, transcription) ; - pour toute requête, avec
GET /(référence : Lire le coût d’une requête) ;v1/ generation? id= … - dans l’onglet « Utilisation » du portail, qui liste les requêtes récentes avec leur coût, leur latence et leur premier jeton (ouvrir).
La réponse d’une conversation donne les jetons dans usage, jamais le coût.
Réserve puis coût réelLien vers la section Réserve puis coût réel
Une requête est payée en deux temps.
- Avant l’appel, elle retient sur le solde le plus qu’elle peut coûter. Si le solde ou un plafond ne couvre pas cette réserve, la requête est refusée avant tout appel au modèle.
- Après la réponse, la réserve est réglée au coût réel : la différence est rendue au solde, ou débitée si le coût réel la dépasse (voir Règlement).
Ce que la réserve couvre :
| Point d’accès | Réserve |
|---|---|
| Conversation | L’entrée comptée large (un jeton par octet de texte, une borne fixe par image selon la famille du modèle, la fenêtre de contexte pour l’audio et les fichiers) et la sortie jusqu’à max_tokens, ou jusqu’à la limite que l’API fixe quand vous n’en donnez pas (voir Longueur de la réponse). |
| Images | Le prix maximal d’une image de la taille demandée (max_credits_per_unit), fois le nombre d’images, plus les images envoyées. |
| Vidéos | Le prix de la durée demandée avec une petite marge, plus les images de départ et de fin pour les modèles qui les facturent. |
| Voix | Le prix du texte à lire. |
| Transcription | Le prix de la durée de l’enregistrement (au moins une minute), avec une marge. |
| Embeddings | Un jeton par octet des textes, plus quelques jetons par texte. |
| OCR | Le prix des pages demandées. |
Refus avant l’appel :
| HTTP | code | Cas |
|---|---|---|
| 402 | insufficient_credits | Le solde ne couvre pas la réserve. Le corps donne required_credits et balance_credits. |
| 402 | spend_cap_exceeded, hold_exceeds_cap | Un plafond de dépense ne couvre pas la réserve (voir Limites). |
| 429 | credits_held_in_progress | Le solde suffirait, mais vos requêtes en cours retiennent le reste. Le corps donne held_credits ; réessayez après Retry-After (2 secondes). |
RèglementLien vers la section Règlement
Pour la conversation (/) :
| Situation | Ce qui est facturé |
|---|---|
| Le fournisseur indique les jetons utilisés | Ces jetons, au prix du modèle. Le montant peut dépasser la réserve. |
| La réponse est terminée mais sans compte de jetons | Une estimation tirée de la longueur de la réponse, jamais plus que la réserve. |
| Le fournisseur échoue avant de produire quoi que ce soit | Rien. |
| Le fournisseur échoue après avoir commencé | L’estimation de ce qui a été produit. |
| Le client part avant la fin, la connexion casse, ou notre délai est dépassé | Le coût réel annoncé ensuite par le fournisseur quand il est disponible ; sinon la réserve, moins la marge prévue pour ce qui ne se mesure pas. |
Pour les médias (images, vidéos, voix, transcription, embeddings, OCR) :
- la requête est facturée au coût réel annoncé par le fournisseur, ou au prix du catalogue pour la quantité produite ;
- dans de rares cas, le coût réel dépasse la réserve : il est alors facturé en entier, et le solde peut passer sous zéro ;
- une requête qui échoue, refusée par le modèle ou coupée par notre délai, ne coûte rien ;
- un modèle d’image qui répond par du texte au lieu d’une image facture ce texte ;
- l’OCR facture un prix fixe par page lue.
RechargerLien vers la section Recharger
Le propriétaire ou un admin du workspace recharge depuis le portail : menu du compte › « API développeur », onglet « Facturation », bloc « Recharger » (ouvrir).
- Choisissez un montant dans « Montant à ajouter », ou « Autre montant ». Les bornes sont affichées sous le champ.
- Le formulaire détaille « Crédits ajoutés », « Total crédité sur votre solde », les « Frais de recharge » et le « Total à payer HT ». « La TVA est ajoutée au paiement selon votre adresse de facturation. »
- « Continuer vers le paiement » ouvre la page de paiement.
- Le solde est crédité dès que le paiement est confirmé, et un e-mail le confirme.
Crédits offertsLien vers la section Crédits offerts
Quand une offre est en cours, le formulaire l’annonce et montre les « Crédits offerts » ajoutés à la recharge avant le paiement. Les crédits offerts :
- ne sont pas remboursables ;
- sont repris si la recharge est remboursée ou contestée ;
- sont dépensés après vos crédits payés.
Remboursements et litigesLien vers la section Remboursements et litiges
Si une recharge est remboursée ou contestée, les crédits qu’elle a apportés sont repris (« Repris après un remboursement ou un litige »), et le solde peut devenir négatif. Un litige gagné les rend (« Rendu après un litige »).
Recharge automatiqueLien vers la section Recharge automatique
Le bloc « Recharge automatique » recharge le solde quand il passe sous un seuil.
| Réglage | Rôle |
|---|---|
| « Quand le solde passe sous (€) » | Le seuil qui déclenche une recharge. Il doit être inférieur au montant rechargé. |
| « Montant de recharge (€) » | Le montant de chaque recharge, dans les mêmes bornes qu’une recharge manuelle. |
- Elle utilise une carte que vous avez enregistrée lors d’une de vos recharges manuelles : « Faites une recharge manuelle d’abord pour enregistrer une carte pour la recharge automatique. »
- « Chaque recharge automatique est facturée comme une recharge manuelle, frais de service et TVA en sus, avec une facture. »
- Elle se déclenche aussi quand une requête est refusée faute de solde. Un délai entre deux recharges et un nombre maximal par jour évitent les doubles prélèvements.
- Elle se coupe d’elle-même si la carte est refusée ou demande une validation, après plusieurs échecs de suite, ou si la carte fait l’objet d’un litige. Le propriétaire et le contact de facturation sont prévenus par e-mail.
- Elle s’arrête aussi quand la personne dont la carte paie quitte le workspace.
Crédit API inclus dans un forfaitLien vers la section Crédit API inclus dans un forfait
Certains forfaits payants de Moon AI incluent un crédit API chaque mois ; le portail l’indique (« Crédit API mensuel inclus à partir du forfait ») et la page des tarifs donne les montants.
- Il est ajouté au porte-monnaie du workspace au début de chaque période du forfait, tant que l’abonnement est payé (pas pendant un essai).
- Il ne se cumule pas : la part non utilisée expire au début de la période suivante (« Crédit inclus non utilisé, expiré »).
- Si le workspace passe pendant la période à un forfait qui en inclut davantage, la différence est ajoutée au prorata du temps restant.
- Il est dépensé avant vos crédits payés, et n’est jamais remboursé.
Factures et historiqueLien vers la section Factures et historique
Dans l’onglet « Facturation » du portail :
- « Historique des crédits » liste chaque mouvement : « Recharge », « Recharge automatique », « Crédits offerts », « Crédit API inclus dans votre forfait », « Crédits offerts par Moon AI », « Ajustement par Moon AI », reprises après un remboursement ou un litige ;
- « Factures » donne une facture par recharge, avec son numéro, le détail HT et TVA, « Voir » et « Télécharger la facture ».
Plafonds et alertesLien vers la section Plafonds et alertes
- Des plafonds de dépense par heure, par jour ou sur 30 jours, pour le workspace et pour chaque clé, bornent ce que l’API peut dépenser : voir Limites.
- Le propriétaire et le contact de facturation du workspace reçoivent un e-mail à chaque recharge et à la création d’une clé. Ils en reçoivent aussi un quand un plafond est atteint, quand une requête est refusée faute de solde (au plus une fois par 24 heures) et quand la recharge automatique se coupe.