Consommation et facturation
Le crédit, le bloc usage rendu à chaque appel, la part servie par le cache, et ce qui vous arrête avant qu'un coût soit engagé.
L'unité : le crédit
Tout se compte en crédits. Un crédit vaut 0,0005 euro, soit 2 000 crédits pour un euro. C'est l'unité affichée partout : dans les plafonds de vos clés, dans votre relevé, dans l'application.
Le barème par modèle, la marge appliquée, les paliers de recharge et les montants sont sur la page Développeurs. Ils ne sont pas recopiés ici : un prix publié à deux endroits finit par être faux à l'un des deux.
Lire la consommation d'un appel
Chaque réponse porte un bloc usage. Il est rendu aussi en flux, sur le dernier fragment, sans qu'il faille le demander.
| Champ (format OpenAI) | Ce qu'il compte |
|---|---|
prompt_tokens | Jetons d'entrée, hors part relue depuis le cache du fournisseur. |
completion_tokens | Jetons produits par le modèle. |
total_tokens | La somme des deux précédents. |
prompt_tokens_details.cached_tokens | Part d'entrée relue depuis le cache du fournisseur. |
cache_write_tokens | Jetons écrits dans le cache du fournisseur. Ajout Netaix : seuls certains fournisseurs exposent ce chiffre. |
| Champ (format Anthropic) | Équivalent |
|---|---|
input_tokens | Jetons d'entrée hors cache |
output_tokens | Jetons produits |
cache_read_input_tokens | Part relue depuis le cache |
cache_creation_input_tokens | Part écrite dans le cache |
Sur une conversation longue ou un contexte répété, la part relue depuis le cache du fournisseur peut dépasser la part facturée au plein tarif. Elle est facturée à un tarif réduit par le fournisseur. Regardez cached_tokens avant de conclure qu'un appel est cher : c'est souvent le levier le plus simple, en gardant un début de requête stable d'un appel à l'autre.
Le bloc usage ne donne pas le coût en crédits de l'appel. Ce coût dépend du modèle réellement servi, dont le nom est dans le champ model de la même réponse, et du barème de ce modèle.
Le suivi par clé
La consommation se lit dans l'application, clé par clé et modèle par modèle, avec l'état des deux plafonds de chaque clé. Ce relevé est calculé par la même fonction que celle qui refuse les appels au dépassement : ce qu'il affiche est donc ce qui s'appliquera, pas une estimation parallèle.
C'est aussi la raison pratique de n'utiliser qu'une clé par outil : sans cela, un traitement automatique mal réglé se lit comme une dérive de l'usage général, et la facture devient difficile à expliquer au moment où il faut l'expliquer.
Le relevé par l'API
La même lecture est disponible avec votre clé seule, sans session : GET /v1/netaix/usage rend le consommé, le plafond, le restant et la part utilisée, pour la journée en cours et pour le cycle, ainsi que deux indicateurs alerte et depasse.
curl https://app.netaix.fr/v1/netaix/usage \
-H "Authorization: Bearer $NETAIX_API_KEY"- Une clé ne lit que sa propre consommation : ni celle d'une autre clé, ni celle de l'organisation.
- Les chiffres sortent de la même fonction que le refus et que l'écran : ce que vous lisez est ce qui s'appliquera.
- L'unité est le crédit, jamais l'euro ni le jeton. Les montants en euros restent dans l'application et sur la facture.
- Cette route est limitée à 30 requêtes par minute : lisez-la à intervalle raisonnable, pas avant chaque appel.
La liste des champs est dans la référence de l'API.
Ce qui vous arrête, et dans quel ordre
Avant tout appel au fournisseur, donc avant tout coût engagé, la passerelle vérifie dans cet ordre :
- l'enveloppe de l'organisation ;
- pour un compte Développeur, qu'une première recharge a bien été payée (
402/topup_requiredsinon) ; - pour un compte Développeur, que le solde prépayé n'est pas épuisé (
402/insufficient_balancesinon) ; - les deux plafonds propres à la clé (
429sinon).
Un refus ne coûte donc rien. Les détails des plafonds sont sur la page Authentification et clés.
Le contrôle du solde a lieu avant l'appel, et le décompte après, quand la consommation réelle est connue. Un appel entamé avec un solde positif va donc au bout, même s'il le fait passer sous zéro : le solde porte alors cette petite dette, et la recharge suivante l'éponge. C'est le choix assumé, parce que l'inverse voudrait dire couper une réponse en cours de production. Les appels suivants, eux, sont refusés par un 402 tant que le solde n'est pas rechargé.
La facturation
- Un compte Développeur n'a pas d'abonnement : vous rechargez, vous consommez. Pas de frais fixe, pas d'engagement de durée.
- La première recharge se paie avant le premier appel. Il n'y a ni essai gratuit, ni crédit offert.
- Les appels payés avec les propres clés de fournisseur d'une organisation ne consomment pas de crédits Netaix, et ne sont donc ni comptés ni plafonnés ici.
- L'appel à
/moderationsn'est pas décompté en crédits. Il est compté dans le relevé de la clé et soumis à la limite de débit. GET /v1/netaix/usageetPOST /v1/messages/count_tokensn'appellent aucun modèle : ils ne sont pas décomptés en crédits, et restent soumis à la limite de débit.- Facture en euros, émise en France, avec un accord de traitement des données.