> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Tarification
> Comment les actions de l'API puisent des credits dans le pool de ton organisation, avec des tableaux de coûts pour les images, les éditions, les modèles et la vidéo.
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`](/fr/quickstart) 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 :
```
credits = 5 × num_outputs × resolution_multiplier
```
| Résolution | Multiplicateur | Credits par output |
| ---------- | -------------- | ------------------ |
| `1K` | ×1 | 5 |
| `2K` | ×2 | 10 |
| `4K` | ×4 | 20 |
`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](/fr) 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 :
```
credits = round(5 × seconds × engine_multiplier × resolution_multiplier × audio_multiplier)
```
### 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.
| Moteur | Multiplicateur de base | Audio |
| --------------------- | ---------------------- | ------------ |
| `veo_3_1_lite` | ×1 | +67% (×1.67) |
| `veo_3_1` | ×5 | +25% (×1.25) |
| `veo_3_1_fast` | ×2 | +50% (×1.5) |
| `veo_3` | ×5 | +25% (×1.25) |
| `veo_3_fast` | ×2 | +50% (×1.5) |
| `veo_2` | ×4 | — |
| `kling_3_0_pro` | ×2 | +50% (×1.5) |
| `kling_2_6_pro` | ×2 | +25% (×1.25) |
| `kling_2_5_pro_turbo` | ×2 | — |
| `kling_2_0_master` | ×4 | — |
| `seedance_2_0` | ×4 | inclus |
| `sora_2_pro` | ×4 | inclus |
| `runway_gen_4` | ×2 | — |
| `hailuo_02` | ×2 | — |
| `minimax_01` | ×1 | — |
« 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 :
| Groupe de moteurs | Multiplicateurs de résolution |
| --------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Veo 3.x, Sora 2 Pro | `720p` ×1 · `1080p` ×2 · `4K` ×3 (là où le moteur prend en charge le palier) |
| `veo_3_1_lite` | `720p` ×1 · `1080p` ×2 |
| `seedance_2_0` | `480p` ×0.5 · `720p` ×1 · `1080p` ×2.25 |
| Kling, `runway_gen_4`, `hailuo_02`, `minimax_01`, `veo_2` | Résolution fixe — pas de multiplicateur de résolution |
### Exemples chiffrés
`5 × 5 × 2 = 50` credits (résolution fixe, sans audio).
`5 × 8 × 1 × 2 = 80` credits (sans audio).
`5 × 8 × 5 × 2 × 1.25 = 500` credits.
`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`](/fr/guides/errors#insufficient_credits)
**avant** qu'aucun job soit créé — rien n'est facturé et aucune ligne de job
n'existe.
* [`insufficient_credits`](/fr/guides/errors#insufficient_credits) — le pool est en
dessous du coût. Recharge ou fais évoluer le plan.
* [`subscription_inactive`](/fr/guides/errors#subscription_inactive) —
l'organisation n'a aucun abonnement utilisable. Réactive la facturation.
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.