Documentation

Facturation

Paiement à l’usage depuis un portefeuille prépayé. Chaque appel est mesuré au microcent près et consigné dans un registre immuable. Sans abonnement ni engagement, le solde n’expire jamais.

Rechargez votre portefeuille avec Stripe → le solde y est conservé → chaque appel API en déduit le coût en temps réel. Si votre solde tombe à zéro, les appels renvoient 402 insufficient_quota jusqu’à ce que vous effectuiez un nouveau rechargement.

Modèle de tarification

Pour chaque appel, Kunavo calcule le coût utilisateur en retenant le plus élevé de ces deux montants :

user_cost = max(catalog_cost, upstream_cost × markup_factor)

Coût catalogue — prix affiché sur la fiche du modèle (par million de jetons, par image, par seconde de vidéo, etc.) × unités réellement utilisées.
Coût en amont — montant facturé à Kunavo par le fournisseur amont pour l’appel concerné, libellé en crédits, sachant que 1 crédit = $0.005.
Coefficient de majoration — généralement 1.5 (majoration de 50% du coût facturé par le fournisseur en amont). Pour certains modèles de fournisseurs chinois dont le tarif de gros en amont est plus proche du tarif officiel du fournisseur, le coefficient est réduit à 1.2 afin que notre tarif reste inférieur au tarif officiel.

La fonction max() garantit que : (a) vous ne payez jamais moins que le prix catalogue annoncé et (b) nous ne perdons jamais d’argent sur un appel dont le coût en amont augmente fortement et de manière inattendue.

Unités de facturation selon la modalité

Modalité	Unité	Granularité
Conversations	par million de jetons d’entrée + par million de jetons de sortie	Exact au token près ; les tokens de raisonnement sont facturés au tarif de sortie.
Image (t2i / édition)	par image	Par image générée ; les générations partielles ne sont pas facturées.
Vidéo	par vidéo	Prix fixe par séquence, déterminé par le niveau de résolution.

Les longues invites sont facturées selon le tarif du fournisseur pour les longs contextes. Avec GPT-5.5, GPT-5.6 Sol et Terra, ainsi que GPT-6 Astra, une invite dépassant 272K jetons d’entrée est entièrement facturée au tarif 2× pour l’entrée — lectures et écritures du cache comprises — et au tarif 1.5× pour la sortie, publié par OpenAI. Claude n’applique aucun supplément pour les longs contextes : son contexte de 1M jetons est facturé au tarif standard.

Jetons mis en cache

Les modèles de chat mettent en cache les préfixes stables des invites. Les lectures du cache sont facturées bien en dessous du tarif d’entrée normal — 0.10× pour Claude comme pour OpenAI, et 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. Les écritures du cache sont facturées au tarif d’entrée 1.25× sur tous les modèles Claude, y compris les écritures avec un TTL d’une heure (en dessous du tarif 2× d’Anthropic), ainsi que sur GPT-5.6 Sol, Terra et Luna, et GPT-6 Astra ; sur tous les autres modèles, elles sont facturées au tarif d’entrée normal. Chaque catégorie bénéficie de la remise propre au modèle : ses tarifs de mise en cache profitent de la même remise par rapport au tarif catalogue du fournisseur que ses tarifs d’entrée et de sortie. Le plancher max() ci-dessus est calculé en tenant compte du cache, afin que la remise vous soit appliquée et ne soit pas neutralisée par le prix catalogue.

Consultez le guide de mise en cache des invites pour accéder au tableau complet des tarifs, savoir comment activer cache_control et découvrir comment le routage d’affinité de Kunavo maintient le cache actif.

Précision

Tous les montants de Kunavo sont stockés en micro_cents :

1 USD = 100,000,000 micro_cents
1 cent = 1,000,000 micro_cents
Montant minimal facturable : 0.0001 cent ($0.000001). Les appels de chat courants sont souvent facturés à ce plancher.

Le tableau de bord arrondit les petites valeurs à 6 décimales (USD), puis à 2 décimales au-delà d’un cent. La comptabilité interne est exacte.

Rechargement

Alimentez votre portefeuille sur /app/billing via Stripe Checkout : cartes (Visa, Mastercard, Amex, JCB, UnionPay) partout où Stripe est disponible, ainsi qu’Apple Pay, Google Pay et Link partout sauf en Inde. Les moyens de paiement soumis au pays apparaissent selon le marché de l’acheteur : aux États-Unis, Cash App Pay, Klarna, Afterpay, le prélèvement bancaire ACH (réglé sous 3 à 5 jours ouvrés) et les cryptomonnaies (stablecoins), ainsi qu’Affirm pour les rechargements de $100 et plus, et Zip pour les rechargements de $100 à $1,500 ; Alipay et WeChat Pay en Chine continentale ; KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales coréennes en Corée du Sud ; UPI en Inde ; Pix au Brésil ; iDEAL aux Pays-Bas, Bancontact en Belgique, EPS en Autriche, MB WAY au Portugal et Satispay en Italie ; BLIK en Pologne ; le prélèvement direct Bacs au Royaume-Uni ; et Pay by Bank pour les acheteurs du Royaume-Uni, d’Irlande et de Finlande.

Les rechargements sont tarifés en USD et Stripe effectue la conversion. La page de paiement affiche le montant dans votre propre devise et le règle dans cette devise — c’est ainsi que Pix facture en réaux et BLIK en zlotys pour un prix en dollars. Le taux de conversion de Stripe inclut des frais de 2 à 4 % payés par l’acheteur (documentation Stripe Adaptive Pricing, consultée le 2026-10-03) ; payer en USD permet de les éviter, mais les moyens de paiement locaux nécessitent la devise locale. Cela ne concerne pas le prélèvement SEPA : il ne fait pas partie des moyens de paiement activés sur notre compte, n’apparaît donc jamais, et aucun réglage de devise ne peut le modifier. Toute carte émise dans un pays SEPA fonctionne normalement, y compris une carte de débit liée à un compte SEPA.

Tarification par paliers

Rechargement	Avantages	Bonus
$10	$10.00	—
$100	$110.00	+$10 (10%)
$1,000	$1,200.00	+$200 (20%)
$5,000	$6,250.00	+$1,250 (25%)

Le solde n’expire jamais. Effectuez un rechargement et utilisez le solde au fil des mois. Vous pouvez également définir une limite de dépenses mensuelle par clé API depuis /app/keys pour plafonner les dépenses d’une charge de travail donnée : dès que les dépenses de cette clé pour le mois civil dépasseraient le montant fixé, ses appels sont refusés avec une réponse 402 insufficient_quota et aucun montant n’est facturé. Vos autres clés continuent de fonctionner. Le même écran permet de définir une liste d’adresses IP autorisées par clé : les appels provenant de toute autre adresse reçoivent une réponse 403.

Rechargement automatique

Facultatif. Enregistrez une carte une seule fois dans /app/billing et définissez trois montants : le seuil de solde sous lequel le portefeuille doit être rechargé, le montant à ajouter à chaque fois et un plafond mensuel. Le portefeuille se recharge ensuite automatiquement — quelques secondes après qu’un règlement fait passer le solde sous votre seuil et, si une requête est refusée entre-temps pour solde insuffisant, avant que cette requête ne reçoive une réponse — pour qu’un agent sans surveillance ne soit pas interrompu par un 402.

Paramètre	Plage	Remarques
Seuil de déclenchement	$5 – $1,000	Définissez-le au-dessus du montant de votre plus grosse requête unique.
Montant de chaque rechargement	$10 – $1,000, en dollars entiers	Les montants de $100 et $1,000 bénéficient du même bonus qu’une recharge manuelle ; les autres montants n’en bénéficient pas.
Plafond mensuel	montant – $20,000	Comptabilise le montant qui vous est facturé chaque mois civil, hors bonus.

Cartes ou Link. Alipay, WeChat Pay, Pix et les autres moyens de paiement locaux ou bancaires ne peuvent pas être débités automatiquement ; le rechargement automatique nécessite donc une carte — ou un compte Link qui en contient une — même si vous utilisez habituellement ces moyens de paiement. Cinq débits maximum par jour ; trois refus consécutifs mettent le service en pause et vous envoient un e-mail ; la suppression de la carte, une contestation ou un blocage pour fraude l’arrête immédiatement. Chaque débit envoie un reçu et le relevé affiche KUNAVO* AUTOTOPUP.

Lorsqu’un rechargement est en cours, une requête refusée reçoit une réponse 402 avec Retry-After: 3 ; tout autre refus indique la marche à suivre. Vous pouvez désactiver le service ou modifier les valeurs à tout moment sur la même page.

Délais des webhooks

Après la validation de Stripe Checkout, votre solde est mis à jour par webhook. Celui-ci se déclenche généralement dans les 5–10 secondes suivant la confirmation du paiement. Les paiements par carte sont presque instantanés ; le règlement peut prendre plusieurs jours avec un moyen de paiement dont la confirmation est uniquement asynchrone. Ces commandes affichent processing jusqu’à l’arrivée des fonds, puis le webhook de règlement crédite le portefeuille : vous n’avez pas à payer de nouveau et rien n’expire entre-temps. Une commande jamais finalisée affiche pending et notre tâche de nettoyage la renomme expired après 24 heures ; ce libellé est purement indicatif et n’annule rien.

Registre des crédits

Chaque modification du solde est consignée dans un registre en ajout seulement :

Type	Direction	Quand
topup	crédit (+)	Paiement Stripe confirmé.
consume	débit (−)	Appel API facturé à son terme.
refund	crédit (+)	Remboursement Stripe ou crédit manuel par un administrateur.
manual_adjust	crédit (+/−)	Correction d’un opérateur (par ex. remboursement lié à un incident).

balance_after_micro_cents est inscrit sur chaque ligne et fournit un instantané par événement. Consultez l’historique complet sur /app/billing.

Journaux d’utilisation

Chaque appel API crée une ligne dans usage_logs :

Modèle, statut (réussite / erreur), code d’état HTTP
Jetons d’entrée / de sortie, jetons mis en cache et écrits dans le cache, nombre d’images, secondes, caractères
upstream_cost_micro_cents — ce que Kunavo a payé au fournisseur en amont
cost_micro_cents — ce que vous avez payé (après majoration)
Latence, IP de la requête, agent utilisateur, préfixe de la clé API

Consultable dans /app/usage avec des filtres et des pages détaillées pour chaque appel.

Appels échoués : sont-ils facturés ?

Non. Kunavo ne facture que lorsque status = success. Si le fournisseur en amont renvoie une erreur 4xx / 5xx ou si notre tâche expire, l’appel est enregistré, mais son coût est $0. Nous prenons nous-mêmes en charge le coût auprès du fournisseur en amont au lieu de vous le répercuter.

Remboursements

Les remboursements sont étudiés au cas par cas via support@kunavo.com. Voici les cas courants dans lesquels nous effectuons un remboursement :

Une panne du côté de Kunavo qui vous a fait perdre du budget.
Des erreurs de tarification qui vous ont fait payer plus que les prix affichés dans le catalogue.
Un double rechargement accidentel via Stripe.

Par défaut, les remboursements sont versés sous forme de crédit sur votre portefeuille ; les remboursements sur compte bancaire via Stripe sont également possibles sur demande.