---
title: "Utilizzo dell'API, crediti e rate limit"
description: "Come l'uso di API e MCP consuma i tuoi crediti, come monitorarlo e i rate limit."
url: https://help.samsa.ai/it/articles/145-utilizzo-dell-api-crediti-e-rate-limit
collection: "API & MCP"
updated: 2026-07-07
language: it
alternates: [en, de, fr]
---

# Utilizzo dell'API, crediti e rate limit

Come l'uso di API e MCP consuma i tuoi crediti, come monitorarlo e i rate limit.

## 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](https://docs.samsa.ai/guides/pricing) 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](https://docs.samsa.ai/guides/rate-limits) (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](https://docs.samsa.ai/guides/errors) elenca cosa significa ciascuno e come rispondere (si apre in una nuova scheda).
