Tout ce que tu crées via l'API ou un assistant connecté utilise les mêmes crédits que l'app Samsa — il n'y a pas de solde API distinct.
L'activité API et MCP est prélevée sur le pool de crédits mensuel de ton organisation — le même pool que celui de l'app — et respecte les éventuels budgets d'équipe que tu as configurés. Une génération coûte le même nombre de crédits, qu'elle soit faite dans l'app, via l'API ou par un assistant connecté. Les actions en lecture seule — lister les modèles, vérifier l'état d'une tâche ou consulter ton solde — sont gratuites.
Si les crédits de ton organisation sont épuisés, les requêtes qui coûtent des crédits échouent jusqu'à ce que le pool soit rechargé ou réinitialisé. Pour comprendre le fonctionnement du pool commun et des budgets, voir Crédits partagés et Équipes & budgets de crédits.
Tu peux voir exactement ce que font tes clés :
Onglet Clés API — dans Paramètres de l'organisation > Clés API, chaque clé affiche ses requêtes, les crédits utilisés (cette période / 30 derniers jours / depuis le début), sa dernière utilisation et une répartition des crédits par type d'action.
Analyses — ouvre le menu avatar en bas à gauche et choisis Analyses ; la section API montre l'utilisation de l'API dans ton organisation.
Différentes actions coûtent différents montants de crédits — une vidéo coûte plus qu'une seule image, et les résolutions plus élevées coûtent plus. L'API utilise la même tarification que l'app. Pour la tarification actuelle par action, voir le guide de tarification dans la documentation développeur (s'ouvre dans un nouvel onglet).
Pour que le service reste rapide et fiable pour tout le monde, l'API applique des limites de requêtes — un plafond sur le nombre de requêtes que tu peux faire dans un court laps de temps. Si tu dépasses, l'API te demande d'attendre un instant et de réessayer. Les limites actuelles et comment les gérer sont dans le guide des limites de requêtes (s'ouvre dans un nouvel onglet).
Si une requête ne peut pas aboutir — par exemple un scope manquant, pas assez de crédits, ou trop de requêtes — l'API renvoie une erreur claire qui explique pourquoi. Le guide des erreurs liste ce que chacune signifie et comment y répondre (s'ouvre dans un nouvel onglet).
