---
title: "Introduzione alla Samsa API"
description: "Cosa permettono la Samsa API e MCP, chi può usarli e da dove iniziare."
url: https://help.samsa.ai/it/articles/144-introduzione-alla-samsa-api
collection: "API & MCP"
updated: 2026-07-07
language: it
alternates: [en, de, fr]
---

# Introduzione alla Samsa API

Cosa permettono la Samsa API e MCP, chi può usarli e da dove iniziare.

## Introduzione alla Samsa API

Con la Samsa API usi Samsa fuori dall'app — generi immagini e video, addestri e gestisci i tuoi modelli e controlli il consumo di crediti dai tuoi strumenti, script o automazioni. Puoi anche collegare assistenti IA come Claude e ChatGPT a Samsa tramite **MCP**, così creano contenuti per te direttamente in chat.

Questa raccolta ti guida attraverso le parti che gestisci dentro Samsa. Per il riferimento tecnico completo — endpoint, formati delle richieste ed esempi di codice — vai alla [documentazione per sviluppatori di Samsa](https://docs.samsa.ai) (si apre in una nuova scheda).

### Cosa puoi fare

-   **Generare immagini** da un prompt, opzionalmente con i tuoi modelli addestrati
    
-   **Modificare immagini** con Magic Edit
    
-   **Generare video** da un fotogramma iniziale, da testo o da testo stilizzato con i tuoi modelli
    
-   **Addestrare e gestire modelli** — creare, elencare, aggiornare ed eliminare i tuoi modelli
    
-   **Controllare l'utilizzo** — leggere il saldo crediti e il consumo della tua organizzazione
    

### Chi può usarla

-   I **proprietari e gli admin dell'organizzazione** creano e gestiscono le chiavi API che sbloccano l'API.
    
-   Chiunque tu condivida una chiave (o qualsiasi assistente IA che colleghi) lavora poi entro i permessi di quella chiave e con i crediti della tua organizzazione.
    

L'accesso all'API è legato alla tua **organizzazione**, non a un account personale — chiavi, crediti e utilizzo appartengono tutti all'organizzazione.

### Come funziona, in breve

L'API è **basata su job**: quando le chiedi di generare un'immagine o un video, accetta la richiesta e ti restituisce un job di cui puoi controllare lo stato finché non è pronto. Tutto ciò che crei costa gli stessi crediti dell'app e viene prelevato dal pool della tua organizzazione (e dagli eventuali budget dei team che hai impostato).

### Due modi per collegarti

-   **API diretta** — usa una **chiave API** da qualsiasi strumento o script in grado di fare richieste web. Inizia da **Creare e gestire le chiavi API**.
    
-   **MCP** — collega un assistente IA (Claude, ChatGPT e altri) così usa Samsa al posto tuo. Vedi **Collegare un client MCP**.
    

### Come proseguire

-   **Configurare l'accesso:** **Creare e gestire le chiavi API**
    
-   **Collegare un assistente:** **Collegare un client MCP (Claude, ChatGPT e altri)**
    
-   **Capire i costi:** **Utilizzo dell'API, crediti e rate limit**
    
-   **Essere avvisato quando i job finiscono:** **Webhook**
    
-   **Riferimento completo per sviluppatori:** la [documentazione per sviluppatori di Samsa](https://docs.samsa.ai), incluso il [Quickstart](https://docs.samsa.ai/quickstart) e il [riferimento API](https://docs.samsa.ai/api-reference/introduction)
