> ## 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.
# Prezzi
> Come le azioni API prelevano credits dal pool della tua organizzazione, con tabelle di costo per immagini, modifiche, modelli e video.
La Samsa API usa gli **stessi credits** dell'app. Ogni azione API preleva dal pool di
credits Samsa esistente della tua organizzazione alle **stesse tariffe** che paghi
nell'app — non c'è un listino prezzi API separato né una tariffa API per posto.
I credits sono condivisi tra l'app e l'API. Un'immagine che generi tramite l'API
costa esattamente quanto costa la stessa immagine nell'app, ed entrambe attingono
allo stesso saldo dell'organizzazione. Controllalo in qualsiasi momento con
[`GET /credits`](/it/quickstart) o `GET /me`.
## Generazione di immagini
La generazione di immagini costa **5 credits per output a `1K`**, scalati per la
risoluzione e moltiplicati per il numero di output:
```
credits = 5 × num_outputs × resolution_multiplier
```
| Risoluzione | Moltiplicatore | Credits per output |
| ----------- | -------------- | ------------------ |
| `1K` | ×1 | 5 |
| `2K` | ×2 | 10 |
| `4K` | ×4 | 20 |
`num_outputs` ha come valore predefinito **1** (il valore predefinito dell'app è 4).
Per esempio, 4 output a `2K` costano `5 × 4 × 2 = 40` credits.
## Magic Edit
Un Magic Edit (`POST /images/edits`) costa **5 credits** per modifica alla
risoluzione di base. Quando l'engine scelto espone livelli di risoluzione più alti, si
applicano gli stessi moltiplicatori `1K`/`2K`/`4K` della generazione di immagini, e più
output moltiplicano il costo allo stesso modo. Gli engine con una risoluzione fissa
vengono sempre addebitati alla base di 5 credits per output.
## Creazione di modelli
Creare un modello personalizzato (`POST /models`) costa **0 credits** — è un'azione
fatturabile registrata per il tuo audit trail, addebitata a zero. Sei fatturato per
generare *con* il modello, non per crearlo.
Il "training" LoRA legacy è deprecato e non disponibile tramite l'API — gli endpoint
di training legacy restituiscono `410 Gone`. "Creazione di modelli" e "addestramento
di modelli" si riferiscono allo stesso flusso basato su Gemini; consulta la
[panoramica](/it) per capire cosa puoi costruire.
## Generazione di video
Il video è fatturato a una **base di 5 credits al secondo**, poi scalato per l'engine,
la risoluzione e se viene generato audio:
```
credits = round(5 × seconds × engine_multiplier × resolution_multiplier × audio_multiplier)
```
### Moltiplicatori dell'engine
L'`engine` che scegli imposta il moltiplicatore di base. Alcuni engine generano anche
audio, a un moltiplicatore aggiuntivo applicato sopra.
| Engine | Moltiplicatore di 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 | incluso |
| `sora_2_pro` | ×4 | incluso |
| `runway_gen_4` | ×2 | — |
| `hailuo_02` | ×2 | — |
| `minimax_01` | ×1 | — |
"incluso" significa che l'audio viene generato senza costo aggiuntivo di credits
(×1.0). Un "—" significa che l'engine non ha opzione audio. Ometti `engine` per usare
quello predefinito, `veo_3_1_lite`.
### Moltiplicatori di risoluzione
Sugli engine che espongono livelli di risoluzione, le risoluzioni più alte costano di
più:
| Gruppo di engine | Moltiplicatori di risoluzione |
| --------------------------------------------------------- | -------------------------------------------------------------------- |
| Veo 3.x, Sora 2 Pro | `720p` ×1 · `1080p` ×2 · `4K` ×3 (dove l'engine supporta il livello) |
| `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` | Risoluzione fissa — nessun moltiplicatore di risoluzione |
### Esempi svolti
`5 × 5 × 2 = 50` credits (risoluzione fissa, senza audio).
`5 × 8 × 1 × 2 = 80` credits (senza audio).
`5 × 8 × 5 × 2 × 1.25 = 500` credits.
`5 × 5 × 1 = 25` credits (risoluzione fissa, senza audio).
## Rimborsi
Se un job fallisce per un problema di Samsa — un errore terminale del provider dopo che
i credits sono stati dedotti — i credits vengono **rimborsati automaticamente** allo
stesso pool dell'organizzazione da cui erano stati prelevati. Un job `failed` che hai
inviato correttamente non ti costa credits. (Gli errori del client come
`422 validation_error` vengono rifiutati prima che qualsiasi cosa venga addebitata.)
## Quando finisci i credits
Se il pool spendibile dell'organizzazione non può coprire il costo di un'azione, la
richiesta di invio restituisce [`402`](/it/guides/errors#insufficient_credits)
**prima** che qualsiasi job venga creato — nulla viene addebitato e non esiste alcuna
riga di job.
* [`insufficient_credits`](/it/guides/errors#insufficient_credits) — il pool è al di
sotto del costo. Ricarica o esegui l'upgrade.
* [`subscription_inactive`](/it/guides/errors#subscription_inactive) —
l'organizzazione non ha un abbonamento utilizzabile. Riattiva la fatturazione.
Acquista credits, aggiungi top-up e gestisci il tuo piano nell'app Samsa. L'utilizzo
API preleva dallo stesso saldo.