Base URL — alle REST-Endpoints liegen unter
Hier starten
Quickstart
Erstelle einen Key und generiere dein erstes Bild in fünf Schritten, mit
Copy-Paste-Beispielen für curl, Python und TypeScript.
API-Referenz
Die Base URL, die Authentifizierung und die Konventionen, die jeder Endpoint
teilt.
Einen API key erstellen
Keys gehören der Organisation, sind gescopt und werden nur einmal angezeigt.
Ein Org-Admin erstellt sie in deinen Samsa-Einstellungen.
MCP server
Verbinde Samsa mit ChatGPT, Claude oder einem beliebigen MCP client — über
OAuth oder einen API key.
Was du bauen kannst
Bildgenerierung
Verwandle einen Prompt in Bilder und komponiere dabei optional die trainierten
style-, object-, person- und setting-Modelle sowie
Farbpaletten deiner Organisation.
Magic Edit
Bearbeite ein bestehendes Bild per Prompt — mit oder ohne Maske — und nutze
dieselben trainierten Modelle für markenkonforme Ergebnisse.
Videogenerierung
Produziere Video aus einem Startframe (mit optionalem Endframe), aus Text oder
aus Text, der mit deinen trainierten Modellen gestylt ist.
Modelltraining
Erstelle eigene Modelle in vier Kategorien — style, object, person und setting —
aus einer Handvoll Referenzbilder.
POST gibt 202 Accepted mit
einer Job-id zurück, du fragst den passenden GET-Endpoint nach dem Status ab,
und — sobald der Job completed ist — trägt die Antwort presigned URLs zu den
fertigen Assets. Du kannst auch eine webhook_url übergeben, um bei Abschluss
benachrichtigt zu werden, statt abzufragen.
Authentifizierung
Sende deinen Key als Bearer-Token bei jeder Anfrage:images.generate, images.edit, videos.generate,
models.read, models.write, usage.read) und handeln für die Organisation des
Keys — Credits werden aus dem Pool dieser Organisation gezogen und generierte Assets
erscheinen in der App unter dem Konto des Key-Erstellers. Siehe den
Quickstart, um deinen ersten Key zu erstellen.
Model Context Protocol (MCP)
Samsa stellt außerdem einen remote MCP server bereit, damit agentische Clients Medien als Tools generieren und bearbeiten können:Authorization: Bearer <api key> für headless Clients wie Skripte und n8n.
Siehe den MCP-server-Guide für den Tool-Katalog und die
Einrichtung pro Client.
Credits und Preise
API-Aktionen ziehen aus dem bestehenden Samsa-Credit-Pool deiner Organisation zu denselben Raten wie in der App — Bildgenerierung kostet zum Beispiel5 Credits
pro output bei 1K und skaliert mit der Auflösung (1K ×1, 2K ×2, 4K ×4).
Wenn der Pool aufgebraucht ist, geben Anfragen 402 zurück. Prüfe dein Guthaben
jederzeit mit GET /credits oder GET /me.