Skip to main content
L’API Samsa utilise les mêmes credits que l’app. Chaque action de l’API puise dans le pool de credits Samsa existant de ton organisation aux mêmes tarifs que ce que tu paies dans l’app — il n’y a pas de liste de prix API séparée ni de frais API par siège.
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-le à tout moment avec GET /credits ou GET /me.

​
Génération d’images

La génération d’images coûte 5 credits par output en 1K, 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.

​
Magic Edit

Un Magic Edit (POST /images/edits) coûte 5 credits par édition à la résolution de base. Quand le moteur choisi expose des paliers de résolution supérieurs, les mêmes multiplicateurs 1K/2K/4K que la génération d’images s’appliquent, et plusieurs outputs multiplient le coût de la même façon. Les moteurs à résolution fixe sont toujours facturés aux 5 credits de base par output.

​
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

Le engine 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).

​
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 job failed 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é.)

​
Quand tu es à court de credits

Si le pool dépensable de l’organisation ne peut pas couvrir le coût d’une action, la requête de soumission renvoie 402 avant qu’aucun job soit créé — rien n’est facturé et aucune ligne de job n’existe.

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.