# Coûts et porte-monnaie

> Comment l’API se paie : porte-monnaie du workspace compté en crédits, réserve puis coût réel de chaque requête, recharges, recharge automatique et factures.

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 euros

- L’API compte en **crédits** : les prix de `GET /v1/models`, le solde de `GET /v1/credits` et le coût de chaque requête sont en crédits.
- 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/models` plutôt que de le garder en dur.

## Solde

Le solde du porte-monnaie se lit dans l’onglet « Aperçu » du portail, ou par l’API avec `GET /v1/credits` (référence : [Lire le solde](https://realmoon.ai/documentation/api/solde/#credits)). 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.

> [!WARNING]
> **Solde négatif**
>
> Une requête peut coûter plus que sa réserve (voir [Règlement](https://realmoon.ai/documentation/api/couts/#reglement)). Le solde peut alors passer sous zéro. Tant qu’il est négatif, les nouvelles requêtes sont refusées (`402 insufficient_credits`) jusqu’à la prochaine recharge. Le portail le signale : « Votre solde est négatif : les requêtes sont refusées jusqu’à votre prochaine recharge. »

## 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ête `X-Moon-Credits` (voix, transcription) ;
- pour toute requête, avec `GET /v1/generation?id=…` (référence : [Lire le coût d’une requête](https://realmoon.ai/documentation/api/solde/#generation)) ;
- dans l’onglet « Utilisation » du portail, qui liste les requêtes récentes avec leur coût, leur latence et leur premier jeton ([ouvrir](https://chat.realmoon.ai/settings/developer/usage)).

La réponse d’une conversation donne les jetons dans `usage`, jamais le coût.

## Réserve puis coût réel

Une requête est payée en deux temps.

1. **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.
2. **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](https://realmoon.ai/documentation/api/couts/#reglement)).

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](https://realmoon.ai/documentation/api/chat/#longueur)). |
| 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](https://realmoon.ai/documentation/api/limites/#plafonds)). |
| 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). |

> [!TIP]
> **Réduire la réserve**
>
> Sur un modèle à grande sortie, donnez un `max_tokens` adapté à votre besoin : la réserve est plus petite, et plus de requêtes peuvent tourner en même temps sur le même solde. Le coût final, lui, ne dépend que de ce que le modèle a réellement produit.

## Règlement

Pour la conversation (`/v1/chat/completions`) :

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

## Recharger

Le propriétaire ou un admin du workspace recharge depuis le portail : menu du compte › « API développeur », onglet « Facturation », bloc « Recharger » ([ouvrir](https://chat.realmoon.ai/settings/developer/billing)).

1. Choisissez un montant dans « Montant à ajouter », ou « Autre montant ». Les bornes sont affichées sous le champ.
2. 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. »
3. « Continuer vers le paiement » ouvre la page de paiement.
4. Le solde est crédité dès que le paiement est confirmé, et un e-mail le confirme.

> [!NOTE]
> **Applications mobiles**
>
> Dans l’application iPhone, l’onglet « API développeur » est disponible mais la recharge n’y est pas proposée (« Les recharges ne sont pas proposées dans l’application. »). Dans l’application Android, l’onglet n’apparaît pas. Pour recharger, ouvrez `https://chat.realmoon.ai/settings/developer/billing` dans un navigateur.

### 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 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 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 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](https://realmoon.ai/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 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 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](https://realmoon.ai/documentation/api/limites/#plafonds).
- 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.

---

Documentation Moon AI › API développeur › Coûts. Page : https://realmoon.ai/documentation/api/couts/. Modifiée le 7 novembre 2026.

© 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.