Zum Inhalt springen
1折AI 文档
Deutsch

API-Schlüssel abrufen und verwalten

Erstellung von API-Schlüsseln, die mit sk- beginnen, im 1zheai-Console, sowie deren Speicherung, Rotation und Schadensbegrenzung bei einem Leak.

Ein API-Schlüssel (API key) entspricht einem Aufrufrecht und belastet das Guthaben deines Kontos. Diese Seite erklärt, wie du einen erstellst, wo du ihn ablegst und was zu tun ist, wenn etwas schiefgeht.

API-Schlüssel erstellen

Abschnitt mit dem Titel „API-Schlüssel erstellen“

  1. Konsole anmelden

    Öffne 1zheai.com/console.

  2. Neu erstellen

    Klicke im linken Menü auf „API-Schlüssel“ und dann oben rechts auf „API-Schlüssel erstellen“. Gib einen Namen ein, der den Zweck erkennen lässt, z. B. claude-code-macbook, ci-staging. Die übrigen Felder können unverändert bleiben; klicke auf „Änderungen speichern“.

    Felder im Formular:

    FormularfeldStandardBeschreibung
    NameleerUnterscheidet den API-Schlüssel im Aufrufprotokoll anhand dieses Namens
    Ablaufdatumläuft nie abOptional 1 Stunde, 1 Tag, 1 Monat oder ein bestimmtes Datum und eine bestimmte Uhrzeit
    Anzahl1Erstellt mehrere auf einmal; den Namen wird automatisch ein zufälliges Suffix hinzugefügt
    Schalter „Unbegrenztes Kontingent“einNach dem Deaktivieren erscheint „Kontingent (USD)“; dieser API-Schlüssel kann höchstens so viele USD ausgeben
    Modellbeschränkung (unter „Erweiterte Einstellungen“)leer, d. h. alle Modelle sind erlaubtNach Auswahl von Modellen kann dieser API-Schlüssel nur diese Modelle aufrufen
    IP-Whitelist (unter „Erweiterte Einstellungen“)leer, d. h. keine EinschränkungErlaubt nur Aufrufe von den aufgeführten IPs oder CIDR-Netzbereichen

  3. Kopieren & speichern

    API-Schlüssel beginnen mit sk-. Kopiere ihn in einen Passwortmanager oder eine Umgebungsvariable und füge ihn nicht in Chats, Screenshots oder Code-Repositories ein.

Ein API-Schlüssel pro Werkzeug

Abschnitt mit dem Titel „Ein API-Schlüssel pro Werkzeug“

Es wird empfohlen, für jedes Werkzeug und jeden Rechner einen eigenen API-Schlüssel zu erstellen. Drei Vorteile:

  • Das Aufrufprotokoll unterscheidet nach API-Schlüssel; auf einen Blick ist sichtbar, welches Werkzeug wie viel ausgegeben hat.
  • Wenn ein API-Schlüssel kompromittiert wird, wird nur dieser gelöscht; die anderen Werkzeuge sind nicht betroffen.
  • Im Team ist jeder für seinen eigenen API-Schlüssel verantwortlich; beim Verlassen des Teams oder beim Rechnerwechsel wird der entsprechende API-Schlüssel gelöscht.

Wo ablegen

Abschnitt mit dem Titel „Wo ablegen“
Shell 配置（macOS / Linux）
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"

Das projektbezogene .claude/settings.json von Claude Code wird üblicherweise ins Repository eingecheckt; die offizielle Claude-Code-Dokumentation rät ausdrücklich davon ab, Zugangsdaten dort abzulegen. Lege den API-Schlüssel im benutzerbezogenen ~/.claude/settings.json ab oder in einem im Projekt nicht eingecheckten .claude/settings.local.json.

Was tun bei einem Leak

Abschnitt mit dem Titel „Was tun bei einem Leak“
  1. Suche ihn in der Liste „API-Schlüssel“, klicke auf das Symbol „Deaktivieren“ in der Spalte „Aktionen“ oder wähle im Menü „⋯“ die Option „Löschen“. Nach der Deaktivierung ist er sofort ungültig; weitere Aufrufe damit geben 401 Invalid token zurück.
  2. Erstelle einen neuen API-Schlüssel und ersetze ihn an den Stellen, an denen er verwendet wird.
  3. Öffne das Aufrufprotokoll (Menü „Aufrufprotokoll“ in der Konsole), klicke auf „Ausklappen“ und filtere im Feld „Token-Name“ nach dem Namen dieses API-Schlüssels, um zu prüfen, ob in den letzten Aufrufen welche vorkommen, die nicht von dir stammen.

Häufige Fragen

Abschnitt mit dem Titel „Häufige Fragen“
Kann ich denselben API-Schlüssel gleichzeitig für Claude Code und Cursor verwenden?

Ja, ein API-Schlüssel ist nicht an ein Werkzeug gebunden. Wenn er jedoch gemischt wird, lässt sich im Protokoll nicht erkennen, wer ausgegeben hat; deshalb wird empfohlen, getrennte Schlüssel zu erstellen.

Hinweis „Invalid token“ / 401 – liegt das am API-Schlüssel?

Meistens ja. Häufige Ursachen: beim Kopieren mitgeführte Leerzeichen oder Zeilenumbrüche, gelöschter API-Schlüssel, Eingabe in das falsche Feld des Werkzeugs. Die schrittweise Fehlersuche findest du unterFehlercodes und Fehlersuche.

Läuft der API-Schlüssel ab?

Standardmäßig läuft er nie ab. Beim Erstellen oder Bearbeiten kannst du unter „Ablaufdatum“ eine Zeit festlegen; nach Ablauf geben weitere Aufrufe 401 Invalid token zurück, gleich wie die Antwort bei einem falsch eingegebenen API-Schlüssel. Die Spalte „Ablauf“ in der Liste zeigt das Ablaufdatum jedes API-Schlüssels.