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. Il prezzo è lo stesso
su ogni engine text-to-image; un engine offre solo le risoluzioni che supporta
(vedi GET /images/models).
Magic Edit
Un Magic Edit (POST /images/edits) costa 5 credits per output alla risoluzione
di base, moltiplicati per num_images. I tre engine Nano Banana hanno livelli di
risoluzione con gli stessi moltiplicatori della generazione di immagini; gemini e
kontext hanno una risoluzione fissa e costano sempre 5 per output:
La risposta
202 restituisce l’importo dedotto come estimated_credits, insieme
all’engine e alla resolution effettivi. Vedi
Engine e credits.
Upload di immagini
Gli upload di immagini (POST /images/uploads/prepare e POST /images/uploads/{id}/complete, e gli
strumenti MCP prepare_image_upload e complete_image_upload) sono gratuiti. Le
operazioni che esegui poi sull’immagine caricata vengono addebitate come di
consueto.
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).Miglioramento dei prompt
In arrivo. Il miglioramento dei prompt non è ancora attivato, quindi oggi non
viene addebitato nulla. Il prezzo qui sotto vale dal lancio.
POST /prompts/improve, o
lo strumento MCP improve_prompt) costa 1 credit per chiamata, sia per il
target image sia per video. Il credit viene addebitato prima che il modello di
IA venga eseguito, e la risposta 200 lo riporta come credits_charged: 1.
- Se il provider di IA fallisce, il credit viene rimborsato automaticamente e la
chiamata restituisce
502 provider_error. - Una chiamata ripetuta con lo stesso
Idempotency-Keye lo stesso body entro 24 ore restituisce il risultato salvato e non viene addebitata di nuovo. Senza l’header, ogni chiamata viene addebitata. Vedi Idempotenza.
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.)
Un job di immagine che termina
failed con error
delivery_blocked_compliance: <codes> è diverso: gli output sono stati prodotti,
ma la pipeline di compliance li ha trattenuti (vedi
Blocchi di compliance).
Non viene rimborsato automaticamente, e il suo credits_used resta quello
addebitato. Contatta support@samsa.ai con l’id del job.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.