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. Controlla in qualsiasi momento quanto può
spendere una chiave con
GET /credits.Generazione di immagini
La generazione di immagini costa 5 credits per output a1K, scalati per la
risoluzione e moltiplicati per il numero di output:
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.
Operazioni sulle immagini
Le sei operazioni sulle immagini — img2img, variazioni, ridimensionamento, upscale, rimozione dello sfondo e vettorializzazione — prelevano credits alla sottomissione e restituiscono l’importo esatto comeestimated_credits nel 202 (è uguale a quanto
addebitato).
Il moltiplicatore di risoluzione è lo stesso della generazione di immagini:
1K ×1,
2K ×2, 4K ×4. num_outputs vale 1 per impostazione predefinita. Img2img e il
ridimensionamento richiedono una resolution esplicita; le variazioni ereditano la
fascia di risoluzione dell’immagine sorgente (non c’è un parametro resolution) —
una sorgente senza dimensioni recuperabili viene addebitata a 1K.
Upscale
L’upscale è addebitato in base alla fascia di risoluzione di destinazione, moltiplicata per il moltiplicatore di credits del modello. SeedVR e Crystal sono ×1; Magnific Creative e Magnific Precision sono ×3.
† Per Crystal,
14K e oltre sono addebitati in base ai megapixel di output (vedi
sotto), non a questo valore fisso — i valori 14K/16K nella colonna ×1 sono il
prezzo SeedVR. Fino a 12K, Crystal corrisponde esattamente alla colonna ×1.
La colonna Magnific mostra il prezzo della fascia dove il modello può
raggiungerla — i motori Magnific impongono limiti di output per modello, quindi le
fasce più alte sono raggiungibili solo con Crystal. Le classi di risoluzione
oltre
16K (20K–38K) sono solo Crystal.12K (14K e superiori) sono
addebitate in base ai megapixel di output previsti anziché alla tabella delle
fasce:
Esempio svolto — Crystal a 14K
Un upscale Crystal il cui output previsto è 101,6 MP (un’immagine 16:9 di classe
14K) costa ceil(101.6 × 0.6 / 5) × 5 = ceil(12.19) × 5 = 65 credits.I cache hit non costano nulla
La rimozione dello sfondo e la vettorializzazione sono memorizzate nella cache per immagine sorgente. Quando la sorgente è unimage_id che possiedi e un risultato
corrispondente esiste già, la sottomissione restituisce subito 202 con
status: "completed" e estimated_credits: 0 — non viene eseguito alcun nuovo
job e il limite di concorrenza della tua organizzazione non
viene consumato. Ogni altro caso (una sorgente https url o base64, o
un’immagine che possiedi senza un risultato pronto) segue il normale percorso
addebitato.
Un ridimensionamento il cui rapporto di destinazione corrisponde già alla sorgente
(nulla di nuovo da outpaintare) e che non ha un
prompt salta il modello,
restituisce la composizione appiattita e rimborsa gli output inutilizzati — si
completa comunque con completed.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 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:Moltiplicatori dell’engine
L’engine che scegli imposta il moltiplicatore di base. Alcuni engine generano anche
audio, a un moltiplicatore aggiuntivo applicato sopra.
“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ù:Esempi svolti
Kling 2.5 Pro Turbo · 5s
5 × 5 × 2 = 50 credits (risoluzione fissa, senza audio).Veo 3.1 Lite · 8s · 1080p
5 × 8 × 1 × 2 = 80 credits (senza audio).Veo 3.1 · 8s · 1080p · audio
5 × 8 × 5 × 2 × 1.25 = 500 credits.MiniMax 01 · 5s
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 jobfailed 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 saldo che la chiave può spendere non copre il costo di un’azione, la richiesta di invio restituisce402
prima che qualsiasi job venga creato — nulla viene addebitato e non esiste alcuna
riga di job.
insufficient_credits— il saldo è al di sotto del costo e l’organizzazione non ha team attivi (o è un’organizzazione di sistema esente dal budgeting per team); anche il fallback quando la detrazione stessa fallisce operativamente, qualunque sia il regime — riprova prima di concludere che il saldo sia troppo basso. Ricarica o esegui l’upgrade.insufficient_team_credits— lo stesso, per una chiave assegnata a un team con budget proprio. Aumenta il budget, riassegna la chiave o ricarica.insufficient_unallocated_credits— lo stesso, per una chiave non assegnata a un team con budget. Libera credits non allocati, assegna la chiave a un team con margine o ricarica.subscription_inactive— l’organizzazione non ha un abbonamento utilizzabile. Riattiva la fatturazione.
GET /credits riporta il saldo che una chiave può
spendere (available) e lo scope di budget che determina quale dei tre codici riceve.
Acquista credits e top-up
Acquista credits, aggiungi top-up e gestisci il tuo piano nell’app Samsa. L’utilizzo
API preleva dallo stesso saldo.