Utilizzo dell'API, crediti e rate limit
Tutto ciò che crei tramite l'API o un assistente collegato usa gli stessi crediti dell'app Samsa — non c'è un saldo API separato.
Da dove vengono i crediti dell'API
L'attività API e MCP viene prelevata dal pool di crediti mensile della tua organizzazione — lo stesso pool che usa l'app — e rispetta gli eventuali budget dei team che hai impostato. Una generazione costa lo stesso numero di crediti, che sia fatta nell'app, tramite l'API o da un assistente collegato. Le azioni di sola lettura — elencare i modelli, controllare lo stato di un job o leggere il saldo — sono gratuite.
Se i crediti della tua organizzazione si esauriscono, le richieste che costano crediti falliscono finché il pool non viene ricaricato o si azzera. Per capire come funzionano il pool condiviso e i budget, vedi Crediti condivisi e Team e budget di crediti.
Tracciare l'utilizzo dell'API
Puoi vedere esattamente cosa fanno le tue chiavi:
Scheda Chiavi API — in Impostazioni organizzazione > Chiavi API, ogni chiave mostra le sue richieste, i crediti utilizzati (questo periodo / ultimi 30 giorni / da sempre), quando è stata usata l'ultima volta e una suddivisione dei crediti per tipo di azione.
Analisi — apri il menu avatar in basso a sinistra e scegli Analisi; la sezione API mostra l'utilizzo dell'API nella tua organizzazione.
Quanto costano le azioni
Azioni diverse costano quantità diverse di crediti — un video costa più di una singola immagine, e le risoluzioni più alte costano di più. L'API usa gli stessi prezzi dell'app. Per i prezzi attuali per azione, vedi la guida ai prezzi nella documentazione per sviluppatori (si apre in una nuova scheda).
Rate limit
Per mantenere il servizio veloce e affidabile per tutti, l'API applica dei rate limit — un tetto al numero di richieste che puoi fare in una breve finestra di tempo. Se lo superi, l'API ti chiede di aspettare un momento e riprovare. I limiti attuali e come gestirli sono nella guida ai rate limit (si apre in una nuova scheda).
Quando una richiesta viene rifiutata
Se una richiesta non può andare a buon fine — per esempio uno scope mancante, crediti insufficienti o troppe richieste — l'API restituisce un errore chiaro che spiega il motivo. La guida agli errori elenca cosa significa ciascuno e come rispondere (si apre in una nuova scheda).