---
title: "API-Schlüssel erstellen und verwalten"
description: "API-Schlüssel erstellen, mit Scopes versehen, verfolgen und widerrufen — und sicher aufbewahren."
url: https://help.samsa.ai/de/articles/143-api-schlussel-erstellen-und-verwalten
collection: "API & MCP"
updated: 2026-07-07
language: de
alternates: [en, fr, it]
---

# API-Schlüssel erstellen und verwalten

API-Schlüssel erstellen, mit Scopes versehen, verfolgen und widerrufen — und sicher aufbewahren.

## API-Schlüssel erstellen und verwalten

Ein **API-Schlüssel** ist das, was einem Tool, Skript oder KI-Assistenten erlaubt, im Namen deiner Organisation zu handeln. Schlüssel werden innerhalb von Samsa von Inhabern und Admins erstellt und verwaltet.

### Wo du API-Schlüssel findest

Öffne **Organisationseinstellungen** > **API-Schlüssel**. Nur **Inhaber und Admins der Organisation** können Schlüssel verwalten — wenn du den Tab nicht siehst, bitte einen Admin um Zugriff.

### Einen Schlüssel erstellen

1.  Gehe zu **Organisationseinstellungen** > **API-Schlüssel** und klicke auf **API-Schlüssel erstellen**.
    
2.  Gib dem Schlüssel einen **Namen**, den du später wiedererkennst — zum Beispiel „CI-Pipeline" oder „Zapier".
    
3.  Wähle die **Scopes** (Berechtigungen), die der Schlüssel haben soll — nimm nur, was er wirklich braucht (siehe unten).
    
4.  Lege fest, wann der Schlüssel **abläuft** — 30 Tage, 90 Tage, 1 Jahr, Nie oder ein eigenes Datum.
    
5.  Klicke auf **Schlüssel erstellen**.
    

**Kopiere deinen Schlüssel sofort.** Samsa zeigt den vollständigen Schlüssel **nur ein einziges Mal** an, in einem Dialog mit dem Titel „Dein neuer API-Schlüssel". Aus Sicherheitsgründen wird nur ein Hash gespeichert — wenn du den Schlüssel verlierst, kannst du ihn nicht wiederherstellen und musst einen neuen erstellen. Füge ihn direkt in dein Tool oder einen sicheren Secrets-Manager ein und bestätige dann „Ich habe den Schlüssel sicher gespeichert".

Jeder Schlüssel beginnt mit `samsa_sk_`, sodass er leicht zu erkennen ist.

### Scopes (Berechtigungen)

Scopes halten jeden Schlüssel genau auf das begrenzt, was er braucht. Samsa bietet:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Scope</p></th><th colspan="1" rowspan="1"><p>Was er erlaubt</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Bilder generieren</strong></p></td><td colspan="1" rowspan="1"><p>Neue Bilder erstellen und ihren Status prüfen</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Bilder bearbeiten</strong></p></td><td colspan="1" rowspan="1"><p>Bestehende Bilder bearbeiten und den Bearbeitungsstatus prüfen</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Videos generieren</strong></p></td><td colspan="1" rowspan="1"><p>Neue Videos erstellen und ihren Status prüfen</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Modelle lesen</strong></p></td><td colspan="1" rowspan="1"><p>Modelle deiner Organisation auflisten und ansehen</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Modelle verwalten</strong></p></td><td colspan="1" rowspan="1"><p>Modelle erstellen, aktualisieren und löschen</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Nutzung lesen</strong></p></td><td colspan="1" rowspan="1"><p>Credit-Guthaben und Verbrauchsdaten lesen</p></td></tr></tbody></table>

Ein Schlüssel braucht mindestens einen Scope. Gib jedem Schlüssel die **wenigsten Scopes**, die er für seine Aufgabe braucht — ein Schlüssel, der nur Bilder generiert, braucht keinen Zugriff auf die Modellverwaltung.

### Die Nutzung eines Schlüssels beobachten

Die API-Schlüssel-Tabelle zeigt für jeden Schlüssel den **Status** (Aktiv, Abgelaufen oder Widerrufen), wer ihn erstellt hat, wann er abläuft, wann er **zuletzt verwendet** wurde, wie viele **Anfragen** er gestellt hat und die **verwendeten Credits** (diese Periode, letzte 30 Tage oder gesamt). Öffne einen Schlüssel, um eine Aufschlüsselung der Credits nach Aktionstyp zu sehen. Aktiviere **Widerrufene Schlüssel anzeigen**, um alte einzublenden.

### Bearbeiten und widerrufen

-   **Schlüssel bearbeiten** erlaubt dir, einen Schlüssel umzubenennen oder seine Scopes und Ablaufzeit anzupassen.
    
-   **Schlüssel widerrufen** schaltet ihn ab. Integrationen, die diesen Schlüssel verwenden, **funktionieren sofort nicht mehr**, und das Widerrufen lässt sich nicht rückgängig machen — widerrufe einen Schlüssel also, sobald er nicht mehr gebraucht wird oder möglicherweise offengelegt wurde.
    

### Schlüssel sicher aufbewahren

-   **Behandle einen Schlüssel wie ein Passwort.** Füge ihn nie in öffentlichen Code, Screenshots oder geteilte Chats ein.
    
-   **Bewahre ihn in einem Secrets-Manager auf**, nicht in einfachen Dateien.
    
-   **Nutze möglichst wenige Scopes** und ein **Ablaufdatum** statt „Nie", wo es geht.
    
-   **Widerrufe ungenutzte Schlüssel** und rotiere Schlüssel regelmässig — erstelle einen neuen, stelle dein Tool um und widerrufe dann den alten.
    
-   Wenn ein Schlüssel jemals offengelegt wird, **widerrufe ihn sofort** und erstelle einen Ersatz.
    

Du brauchst die technischen Details zur Nutzung eines Schlüssels in Anfragen? Siehe den [Authentifizierungs-Guide](https://docs.samsa.ai/guides/authentication) in den Entwicklerdocs (öffnet in einem neuen Tab).
