> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Samsa API

> Generiere Bilder, bearbeite sie, produziere Videos und trainiere eigene Modelle — programmatisch, aus dem Samsa-Konto deiner Organisation.

Die **Samsa API** bringt Samsas generatives Bild- und Video-Studio in deine
eigenen Anwendungen. Authentifiziere dich mit einem Organisations-API key, reiche
einen Job ein und frage das Ergebnis ab — dieselben Modelle, trainierten Assets und
derselbe Credit-Pool, den dein Team bereits in der App nutzt, jetzt über eine
saubere REST-Schnittstelle und einen remote [MCP server](/de/mcp-server) verfügbar.

<Info>
  **Base URL** — alle REST-Endpoints liegen unter

  ```
  https://api.samsa.ai/public/v1
  ```
</Info>

## Hier starten

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/de/quickstart">
    Erstelle einen Key und generiere dein erstes Bild in fünf Schritten, mit
    Copy-Paste-Beispielen für curl, Python und TypeScript.
  </Card>

  <Card title="API-Referenz" icon="terminal" href="/de/api-reference/introduction">
    Die Base URL, die Authentifizierung und die Konventionen, die jeder Endpoint
    teilt.
  </Card>

  <Card title="Einen API key erstellen" icon="key" href="/de/quickstart#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.
  </Card>

  <Card title="MCP server" icon="plug" href="/de/mcp-server">
    Verbinde Samsa mit ChatGPT, Claude oder einem beliebigen MCP client — über
    OAuth oder einen API key.
  </Card>
</CardGroup>

## Was du bauen kannst

<CardGroup cols={2}>
  <Card title="Bildgenerierung" icon="image">
    Verwandle einen Prompt in Bilder und komponiere dabei optional die trainierten
    **style**-, **object**-, **person**- und **setting**-Modelle sowie
    Farbpaletten deiner Organisation.
  </Card>

  <Card title="Magic Edit" icon="wand-magic-sparkles">
    Bearbeite ein bestehendes Bild per Prompt — mit oder ohne Maske — und nutze
    dieselben trainierten Modelle für markenkonforme Ergebnisse.
  </Card>

  <Card title="Videogenerierung" icon="clapperboard">
    Produziere Video aus einem Startframe (mit optionalem Endframe), aus Text oder
    aus Text, der mit deinen trainierten Modellen gestylt ist.
  </Card>

  <Card title="Modelltraining" icon="graduation-cap">
    Erstelle eigene Modelle in vier Kategorien — style, object, person und setting —
    aus einer Handvoll Referenzbilder.
  </Card>
</CardGroup>

Jeder Generierungs-Endpoint ist **asynchron**: Ein `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:

```
Authorization: Bearer samsa_sk_your_key_here
```

Keys tragen **Scopes** (`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](/de/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:

```
https://api.samsa.ai/mcp
```

Der MCP-Endpoint unterstützt **duale Authentifizierung** — OAuth 2.1 (mit einem
Consent-Screen in der Samsa-App) für interaktive Clients wie ChatGPT und Claude
sowie `Authorization: Bearer <api key>` für headless Clients wie Skripte und n8n.
Siehe den [MCP-server-Guide](/de/mcp-server) 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 Beispiel `5` 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`.