Les credits sont partagés entre l’app et l’API. Une image que tu génères via
l’API coûte exactement ce que la même image coûte dans l’app, et les deux puisent
dans le même solde d’organisation. Consulte à tout moment ce qu’une clé peut dépenser
avec
GET /credits.Génération d’images
La génération d’images coûte 5 credits par output en1K, mise à l’échelle par
la résolution et multipliée par le nombre d’outputs :
num_outputs vaut 1 par défaut (la valeur par défaut de l’app est 4). Par
exemple, 4 outputs en 2K coûtent 5 × 4 × 2 = 40 credits. Le prix est le même
sur chaque engine text-to-image ; un moteur ne propose que les résolutions qu’il
prend en charge (voir GET /images/models).
Magic Edit
Un Magic Edit (POST /images/edits) coûte 5 credits par output à la résolution
de base, multipliés par num_images. Les trois moteurs Nano Banana ont des paliers
de résolution avec les mêmes multiplicateurs que la génération d’images ; gemini
et kontext ont une résolution fixe et coûtent toujours 5 par output :
Le
202 renvoie le montant débité dans estimated_credits, avec le engine et la
resolution effectifs. Voir
Engines et credits.
Uploads d’images
Les uploads d’images (POST /images/uploads/prepare et POST /images/uploads/{id}/complete, ainsi que
les outils MCP prepare_image_upload et complete_image_upload) sont gratuits.
Les opérations que tu lances ensuite sur l’image uploadée sont facturées
normalement.
Opérations d’images
Les six opérations d’images — img2img, variations, redimensionnement, upscale, suppression d’arrière-plan et vectorisation — puisent chacune des credits à la soumission et renvoient le montant exact commeestimated_credits dans le 202 (il
est égal au montant débité).
Le multiplicateur de résolution est le même que pour la génération d’images :
1K
×1, 2K ×2, 4K ×4. num_outputs vaut 1 par défaut. Img2img et le
redimensionnement prennent une resolution explicite ; les variations héritent du
palier de résolution de l’image source (il n’y a pas de paramètre resolution) —
une source sans dimensions récupérables est facturée au tarif 1K.
Upscale
L’upscale est facturé selon le palier de résolution cible, multiplié par le multiplicateur de credits du modèle. SeedVR et Crystal sont ×1 ; Magnific Creative et Magnific Precision sont ×3.
† Pour Crystal,
14K et au-delà sont facturés selon les mégapixels de sortie
(voir ci-dessous), pas selon ce montant fixe — les valeurs 14K/16K de la colonne
×1 sont le prix SeedVR. Jusqu’à 12K, Crystal correspond exactement à la colonne ×1.
La colonne Magnific indique le prix du palier là où le modèle peut l’atteindre —
les moteurs Magnific imposent des limites de sortie par modèle, donc les paliers
les plus élevés ne sont atteignables qu’avec Crystal. Les classes de résolution
au-dessus de
16K (20K–38K) sont réservées à Crystal.12K (14K et plus)
sont facturées selon les mégapixels de sortie prévus plutôt que selon le tableau
des paliers :
Exemple chiffré — Crystal à 14K
Un upscale Crystal dont la sortie prévue est de 101,6 MP (une image 16:9 de
classe
14K) coûte ceil(101.6 × 0.6 / 5) × 5 = ceil(12.19) × 5 = 65
credits.Les cache hits ne coûtent rien
La suppression d’arrière-plan et la vectorisation sont mises en cache par image source. Lorsque la source est unimage_id que tu possèdes et qu’un résultat
correspondant existe déjà, la soumission renvoie immédiatement 202 avec
status: "completed" et estimated_credits: 0 — aucun nouveau job ne s’exécute
et le plafond de concurrence de ton organisation n’est pas
consommé. Tout autre cas (une source https url ou base64, ou une image que tu
possèdes sans résultat prêt) suit le chemin facturé normal.
Un redimensionnement dont le ratio cible correspond déjà à la source (rien de
nouveau à outpainter) et qui n’a pas de
prompt saute le modèle, renvoie la
composition aplatie et rembourse les outputs inutilisés — il se termine tout de
même en completed.Création de modèles
Créer un modèle personnalisé (POST /models) coûte 0 credit — c’est une action
facturable enregistrée pour ton audit trail, facturée à zéro. Tu es facturé pour
générer avec le modèle, pas pour le créer.
L’« entraînement » LoRA hérité est déprécié et n’est pas disponible via l’API —
les endpoints d’entraînement hérités renvoient
410 Gone. « Création de modèles »
et « entraînement de modèles » désignent le même flux basé sur Gemini ; voir
l’aperçu pour ce que tu peux construire.Génération de vidéos
La vidéo est facturée sur une base de 5 credits par seconde, puis mise à l’échelle par le moteur, la résolution et le fait qu’un audio soit généré ou non :Multiplicateurs de moteur
Leengine que tu choisis fixe le multiplicateur de base. Certains moteurs
génèrent aussi de l’audio, avec un multiplicateur supplémentaire appliqué par
dessus.
« inclus » signifie que l’audio est généré sans coût de credit supplémentaire
(×1.0). Un « — » signifie que le moteur n’a pas d’option audio. Omets
engine
pour utiliser la valeur par défaut, veo_3_1_lite.Multiplicateurs de résolution
Sur les moteurs qui exposent des paliers de résolution, les résolutions supérieures coûtent plus cher :Exemples chiffrés
Kling 2.5 Pro Turbo · 5s
5 × 5 × 2 = 50 credits (résolution fixe, sans audio).Veo 3.1 Lite · 8s · 1080p
5 × 8 × 1 × 2 = 80 credits (sans audio).Veo 3.1 · 8s · 1080p · audio
5 × 8 × 5 × 2 × 1.25 = 500 credits.MiniMax 01 · 5s
5 × 5 × 1 = 25 credits (résolution fixe, sans audio).Amélioration de prompts
Bientôt disponible. L’amélioration de prompts n’est pas encore activée, donc rien
n’est facturé aujourd’hui. Le prix ci-dessous s’applique dès le lancement.
POST /prompts/improve, ou
l’outil MCP improve_prompt) coûte 1 credit par appel, pour le target image
comme pour video. Le credit est débité avant que le modèle d’IA ne tourne, et la
réponse 200 l’indique avec credits_charged: 1.
- Si le fournisseur d’IA échoue, le credit est remboursé automatiquement et l’appel
renvoie
502 provider_error. - Un appel répété avec le même
Idempotency-Keyet le même body dans les 24 heures renvoie le résultat enregistré et n’est pas facturé à nouveau. Sans le header, chaque appel est facturé. Voir Idempotence.
Remboursements
Si un job échoue du côté de Samsa — une erreur de provider terminale après que des credits ont été déduits — les credits sont automatiquement remboursés sur le même pool d’organisation d’où ils ont été prélevés. Un jobfailed que tu as
soumis correctement ne te coûte pas de credits. (Les erreurs client comme
422 validation_error sont rejetées avant que quoi que ce soit soit facturé.)
Un job d’image qui se termine en
failed avec error
delivery_blocked_compliance: <codes> est différent : les outputs ont été
produits, mais le pipeline de conformité les a retenus (voir
Blocages compliance).
Il n’est pas remboursé automatiquement, et son credits_used reste tel que
facturé. Contacte support@samsa.ai avec l’id du job.Quand tu es à court de credits
Si le solde que la clé peut dépenser ne peut pas couvrir le coût d’une action, la requête de soumission renvoie402
avant qu’aucun job soit créé — rien n’est facturé et aucune ligne de job
n’existe.
insufficient_credits— le solde est en dessous du coût, et l’organisation n’a aucune équipe active (ou est une organisation système exemptée du budgeting par équipe) ; aussi le repli quand la déduction elle-même échoue opérationnellement, quel que soit le régime — réessaie avant de conclure à un solde trop bas. Recharge ou fais évoluer le plan.insufficient_team_credits— idem, pour une clé assignée à une équipe ayant son propre budget. Augmente le budget, réassigne la clé ou recharge.insufficient_unallocated_credits— idem, pour une clé non assignée à une équipe budgétée. Libère des credits non alloués, assigne la clé à une équipe ayant de la marge ou recharge.subscription_inactive— l’organisation n’a aucun abonnement utilisable. Réactive la facturation.
GET /credits rapporte le solde qu’une clé peut
dépenser (available) et le scope de budget qui détermine lequel des trois codes elle
reçoit.
Acheter des credits et des top-ups
Achète des credits, ajoute des top-ups et gère ton plan dans l’app Samsa.
L’utilisation de l’API puise dans le même solde.