Erste Schritte mit der Samsa API
Mit der Samsa API nutzt du Samsa ausserhalb der App — du generierst Bilder und Videos, trainierst und verwaltest deine eigenen Modelle und prüfst deinen Credit-Verbrauch aus deinen eigenen Tools, Skripten oder Automationen. Du kannst auch KI-Assistenten wie Claude und ChatGPT über MCP mit Samsa verbinden, damit sie direkt im Chat Inhalte für dich erstellen.
Diese Sammlung führt dich durch die Teile, die du innerhalb von Samsa verwaltest. Die vollständige technische Referenz — Endpunkte, Anfrageformate und Codebeispiele — findest du in den Samsa-Entwicklerdocs (öffnet in einem neuen Tab).
Was du tun kannst
Bilder generieren aus einem Prompt, optional mit deinen trainierten Modellen
Bilder bearbeiten mit Magic Edit
Videos generieren aus einem Startbild, aus Text oder aus Text im Stil deiner Modelle
Modelle trainieren und verwalten — eigene Modelle erstellen, auflisten, aktualisieren und löschen
Nutzung prüfen — Credit-Guthaben und Verbrauch deiner Organisation lesen
Wer sie nutzen kann
Inhaber und Admins der Organisation erstellen und verwalten die API-Schlüssel, die die API freischalten.
Alle, mit denen du einen Schlüssel teilst (oder jeder KI-Assistent, den du verbindest), arbeiten dann im Rahmen der Berechtigungen dieses Schlüssels und mit den Credits deiner Organisation.
Der API-Zugriff ist an deine Organisation gebunden, nicht an ein persönliches Konto — Schlüssel, Credits und Nutzung gehören alle der Organisation.
Wie es kurz gesagt funktioniert
Die API ist auftragsbasiert: Wenn du sie bittest, ein Bild oder Video zu generieren, nimmt sie die Anfrage an und gibt dir einen Auftrag zurück, dessen Status du abrufen kannst, bis er fertig ist. Alles, was du erstellst, kostet dieselben Credits wie in der App und wird aus dem Pool deiner Organisation bezogen (sowie aus allfälligen Team-Budgets, die du eingerichtet hast).
Zwei Wege, dich zu verbinden
Direkte API — nutze einen API-Schlüssel aus jedem Tool oder Skript, das Webanfragen stellen kann. Beginne mit API-Schlüssel erstellen und verwalten.
MCP — verbinde einen KI-Assistenten (Claude, ChatGPT und mehr), damit er Samsa für dich nutzt. Siehe Einen MCP-Client verbinden.
Wie es weitergeht
Zugriff einrichten: API-Schlüssel erstellen und verwalten
Einen Assistenten verbinden: Einen MCP-Client verbinden (Claude, ChatGPT und mehr)
Kosten verstehen: API-Nutzung, Credits und Rate-Limits
Benachrichtigt werden, wenn Aufträge fertig sind: Webhooks
Vollständige Entwicklerreferenz: die Samsa-Entwicklerdocs, inklusive Quickstart und API-Referenz