Facturation & crédits
Fonctionnement des crédits de l’API System One hébergée et gestion de la facturation. Les nouveaux comptes reçoivent 100 crédits à l’inscription ; les crédits n’expirent pas.
L’API System One hébergée utilise des crédits prépayés pour les évaluations. Le Playground et vos connexions API utilisent le même solde de compte. Le SDK open source lui-même n’exige pas ces crédits ; une connexion directe du SDK à un autre service utilise la facturation de ce service. Vérifiez votre solde hébergé dans la console avant de commencer.
Prêt pour les questions
Comment fonctionnent les crédits de l’API System One ? L’usage est décompté en crédits. Les nouveaux comptes reçoivent 100 crédits à l’inscription ; les crédits n’expirent pas. Gérez la facturation dans la console du compte.
Vérifier le prix du modèle sélectionné
Les modèles peuvent avoir des prix différents. Dans le Playground, sélectionnez un modèle et cliquez sur le bouton Model information à côté du sélecteur pour consulter son tarif et ses limites, au lieu de supposer que chaque requête coûte un crédit. La page de tarification concerne les packs de crédits. La disponibilité et les prix des modèles peuvent changer ; voir Choisir un modèle pour ce qu’il faut comparer.
Le Playground estime le coût de la requête courante avant son envoi. Charger un exemple n’est pas une évaluation facturable ; l’exécuter est une vraie requête.
Comment le coût d’une requête est calculé
Le coût dépend de trois éléments :
- Le nombre de questions : chaque question de la requête contribue au débit.
- La taille complète de la requête : on utilise les octets UTF-8 du
pricing.bytesPerBlockdu modèle sélectionné, en arrondissant à l’entier supérieur avec un minimum d’un bloc. - Le tarif du modèle sélectionné : le prix en crédits par question et par bloc.
blocs = max(1, ceil(octetsUtf8DeLaRequeteCanonique / bytesPerBlockDuModele))
credits = nombreDeQuestions × blocs × tarifDuModeleLa « requête canonique » est la requête complète analysée et représentée de façon cohérente, pas seulement le message à examiner. Elle inclut le modèle sélectionné, le contexte, les questions, les noms d’options, les critères et les champs supplémentaires pris en charge. Les espaces de mise en forme n’augmentent pas cette taille de facturation, mais le contenu du texte si. Les octets UTF-8 ne sont pas les caractères : le texte chinois et les emoji peuvent utiliser plusieurs octets par caractère.
Exemples hypothétiques
Uniquement pour le calcul, supposons un modèle utilisant des blocs de 4 096 octets et coûtant 2 crédits par question et par bloc. Ce n’est pas un prix de modèle courant ni une offre.
| Taille de la requête canonique | Questions | Blocs | Coût d’exemple |
|---|---|---|---|
| 1 à 4 096 octets | 1 | 1 | 1 × 1 × 2 = 2 crédits |
| 1 à 4 096 octets | 3 | 1 | 3 × 1 × 2 = 6 crédits |
| 4 097 à 8 192 octets | 3 | 2 | 3 × 2 × 2 = 12 crédits |
Toutes les questions partagent le contexte, mais chaque question est facturée sur le nombre de blocs de la requête complète. Un score ou une probabilité ne change pas le prix : le calcul porte sur la requête, pas sur votre accord avec la réponse. Les comptes de jetons, lorsqu’ils sont affichés, sont une information d’usage distincte et ne remplacent pas cette formule de crédits.
La requête soumise complète doit aussi respecter les limits.bytes du modèle sélectionné : Jev et les modes HTTP conservent 64 Ko (65 536 octets) ; les entrées Clef et Clef Flash migrées autorisent jusqu’à 13 Mo (13 631 488 octets).
Acheter un pack de crédits unique
Connectez-vous et ouvrez la page de tarification, ou la section d’achat de la page de facturation de votre console. Choisissez un pack et vérifiez le montant, la devise et le nombre de crédits au moment du paiement.
Les packs de crédits sont des achats uniques, pas des abonnements récurrents. Le paiement affiché fait foi ; ce guide ne fixe ni montant ni prix de pack. Après confirmation du paiement, vérifiez votre solde de compte. Si le paiement semble terminé alors que les crédits ne sont pas arrivés, contactez le support avec votre référence de commande au lieu de payer à nouveau immédiatement.
Crédits de bienvenue
Les nouveaux comptes reçoivent 100 crédits gratuits à l’inscription. Chaque compte reçoit cet octroi une seule fois. Créer d’autres clés d’API ou se reconnecter n’ajoute pas de crédits de bienvenue.
Comment fonctionnent les blocs de facturation
Le coût est fondé sur la taille de la requête : chaque 4 Ko est un bloc, et une taille inférieure à 4 Ko compte quand même comme un bloc. Coût = blocs × questions × prix unitaire du modèle.
Par exemple, une requête de 6 Ko avec 2 questions sur Jev (1 crédit par bloc) = 2 blocs × 2 × 1 = 4 crédits.
Les crédits n’expirent jamais
Les crédits n’expirent jamais. Vous voyez votre historique d’usage récent dans la console. Consulter un historique plus ancien plus tard ne change pas votre solde.
Échecs, requêtes répétées et résultats incertains
| Ce qui s’est passé | Ce que cela signifie pour vous |
|---|---|
| La requête a été rejetée pour une raison de connexion, d’entrée ou de crédits insuffisants avant l’évaluation. | Aucun nouveau débit d’évaluation n’est créé. Corrigez la cause avant de réessayer. |
| Une évaluation a échoué et la restitution de ses crédits est confirmée. | Les crédits de l’évaluation ont été restitués. C’est un ajustement de crédits, pas un remboursement en espèces. |
| Le service signale que la facturation est encore en cours de résolution. | Le débit final n’est pas encore connu. Vérifiez l’usage et contactez le support si cela reste non résolu. |
| Votre navigateur ou votre application a expiré, s’est déconnecté ou a été fermé. | Cela ne prouve pas que la requête a échoué ou était gratuite. Vérifiez l’usage avant de renvoyer. |
| Une connexion API récupère une réponse avec la requête d’origine et sa clé de rejeu. | La réponse récupérée n’est pas débitée à nouveau. C’est un rejeu, pas une nouvelle évaluation. |
| Vous relancez le Playground ou faites une nouvelle requête API. | Cela peut être une nouvelle évaluation facturable, même si les questions semblent identiques. |
La clé de rejeu s’appelle clé d’idempotence dans l’API. Créez une nouvelle clé pour chaque nouvelle opération métier ; conservez-la avec la requête complète et réutilisez les deux uniquement pour les reprises de cette opération. Les clés sont scopées à votre compte : changer de clé d’API ne crée pas une portée de rejeu distincte. Dans la fenêtre de rétention, la même clé avec une requête modifiée renvoie 409 idempotency_conflict sans nouveau débit d’évaluation. Une requête réussie identique est rejouée sans nouveau débit.
Les réponses réussies peuvent être récupérées pendant 24 heures à partir de la création de la requête. Ce n’est pas une protection permanente contre les doublons. Un X-System-One-Credits: 0 sur une reprise signifie qu’aucun débit supplémentaire n’a été appliqué pour cette tentative HTTP, pas que l’opération d’origine était gratuite. Voir Clé d’idempotence.
Ne supposez pas qu’une valeur de débit absente vaut zéro, ni que chaque erreur confirme une restitution de crédits.
Les remboursements en espèces des achats sont distincts des crédits restitués pour des évaluations échouées. Pour une question d’achat, contactez support@system-one.dev ; ce guide ne promet pas de remboursement automatique en espèces.
Consulter l’usage et obtenir de l’aide
La console affiche votre solde et votre activité pour les 30 derniers jours calendaires UTC, y compris les 50 dernières requêtes de cette période. Les frontières de journée UTC peuvent différer de votre heure locale. Cette vue récente n’est pas un historique complet à vie.
Pour un débit que vous ne comprenez pas, conservez l’identifiant de requête si disponible, l’heure approximative et toute référence de commande. Envoyez ces éléments à support@system-one.dev. N’envoyez jamais de clé d’API, de code de connexion ni de détails complets de carte bancaire.
Historique d’usage plus ancien
Les crédits n’expirent jamais. La console affiche votre historique d’usage récent. Les enregistrements plus anciens peuvent quitter cette vue récente ; vos crédits disponibles et vos totaux à vie restent inchangés. Vous pouvez télécharger vos propres enregistrements plus anciens depuis la page de facturation.
Liens internes : Choisir un modèle, Clé d’idempotence, Données et confidentialité.