Base URL — tutti gli endpoint REST vivono sotto
Inizia qui
Quickstart
Crea una chiave e genera la tua prima immagine in cinque passaggi, con esempi
copia-incolla in curl, Python e TypeScript.
Riferimento API
Il base URL, l’autenticazione e le convenzioni condivise da ogni endpoint.
Crea una API key
Le chiavi sono di proprietà dell’organizzazione, hanno degli scope e vengono
mostrate una sola volta. Un admin dell’organizzazione le crea nelle tue
impostazioni Samsa.
MCP server
Connetti Samsa a ChatGPT, Claude o qualsiasi client MCP tramite OAuth o una API key.
Cosa puoi costruire
Generazione di immagini
Trasforma un prompt in immagini, componendo facoltativamente i modelli
style, object, person e setting addestrati dalla tua
organizzazione e le palette di colori.
Magic Edit
Modifica un’immagine esistente con un prompt — con o senza maschera — e riusa gli
stessi modelli addestrati per risultati fedeli al tuo brand.
Generazione di video
Produci video da un frame iniziale (con un frame finale facoltativo), da testo o
da testo stilizzato con i tuoi modelli addestrati.
Addestramento di modelli
Crea modelli personalizzati in quattro categorie — style, object, person e
setting — a partire da una manciata di immagini di riferimento.
POST restituisce 202 Accepted
con un id del job, tu interroghi l’endpoint GET corrispondente per lo stato e —
una volta che il job è completed — la risposta contiene presigned URL agli asset
finiti. Puoi anche passare un webhook_url per essere notificato al completamento
invece di interrogare.
Autenticazione
Invia la tua chiave come bearer token in ogni richiesta:images.generate, images.edit, videos.generate,
models.read, models.write, usage.read) e agiscono per l’organizzazione della
chiave — i credits vengono prelevati dal pool di quell’organizzazione e gli asset
generati appaiono nell’app sotto l’account di chi ha creato la chiave. Consulta il
quickstart per creare la tua prima chiave.
Model Context Protocol (MCP)
Samsa espone anche un MCP server remoto affinché i client agentici possano generare e modificare media come strumenti:Authorization: Bearer <api key> per client headless come script e n8n.
Consulta la guida all’MCP server per il catalogo degli strumenti e
la configurazione per ciascun client.
Credits e prezzi
Le azioni API prelevano dal pool di credits Samsa esistente della tua organizzazione alle stesse tariffe dell’app — per esempio, la generazione di immagini costa5
credits per output a 1K, scalando con la risoluzione (1K ×1, 2K ×2, 4K ×4).
Quando il pool è esaurito, le richieste restituiscono 402. Controlla il tuo saldo in
qualsiasi momento con GET /credits o GET /me.