Skip to main content
Ein API-Schlüssel authentifiziert deine Anfragen an Novita AI. Diese Seite erklärt, wie Schlüssel funktionieren, wie du einen erstellst und speicherst und wie du dafür sorgst, dass er in deinen Umgebungen funktionsfähig bleibt. Verwende diese Seite, um:
  • Anfragen an Novita AI mit einem Bearer-API-Schlüssel zu authentifizieren.
  • Einen API-Schlüssel in der Konsole zu erstellen und sicher zu speichern.
  • Deinen Schlüssel als Umgebungsvariable unter Linux, macOS und Windows zu konfigurieren.
  • Zu verstehen, wie lange ein Schlüssel gültig bleibt und was die OpenAPI abdeckt und was nicht.

Authentifizierung

Novita AI authentifiziert den API-Zugriff mithilfe der Bearer-Authentifizierung. Sende deinen API-Schlüssel in der Authorization Anfrage-Header:
Eine Beispielanfrage:

API-Schlüssel erstellen

1

Schlüsselverwaltung öffnen

Gehen Sie zur Schlüsselverwaltung in der Konsole.
2

Neuen Schlüssel erstellen

Wählen Sie API-Schlüssel erstellen aus, und geben Sie dem Schlüssel dann einen Namen, der seinen Zweck widerspiegelt, z. B. production oder local-testing.
3

Kopieren und speichern Sie den Schlüssel

Der vollständige Schlüssel wird nur einmal angezeigt, bei der Erstellung. Kopieren Sie ihn sofort und speichern Sie ihn an einem sicheren Ort, z. B. in einem Secrets-Manager oder einer Umgebungsvariable. Wenn Sie ihn verlieren, können Sie ihn nicht wiederherstellen — erstellen Sie stattdessen einen neuen Schlüssel.
Optional können Sie einschränken, welche Modelle ein Schlüssel aufrufen darf. Siehe Modellzugriff für API-Schlüssel.

Schlüsselformat und Gültigkeit

  • Jeder Schlüssel beginnt mit dem sk_ Präfix.
  • Ein Schlüssel wird nur einmal vollständig angezeigt, bei der Erstellung. Danach zeigt die Konsole eine maskierte Form an.
  • Ein Schlüssel bleibt nach der Erstellung unbegrenzt gültig. Er funktioniert weiter, bis du ihn in der Konsole löschst.
  • Jedes Konto kann bis zu 10 API-Schlüssel erstellen.

Was die OpenAPI abdeckt

Du erstellst und löschst API-Schlüssel ausschließlich in der Konsole. Die Novita OpenAPI enthält keine Endpunkte zum Erstellen oder Löschen von Schlüsseln. Die schlüsselbezogenen OpenAPI-Endpunkte decken das Auflisten von Schlüsseln und das Verwalten der Modellzugriffsrichtlinie eines Schlüssels ab:

Speichere deinen Schlüssel als Umgebungsvariable

Das Hartkodieren eines Schlüssels im Quellcode birgt das Risiko, dass er offengelegt wird, zum Beispiel wenn du die Datei commitest. Lies den Schlüssel aus einer Umgebungsvariable wie NOVITA_API_KEY hält ihn aus deinem Code heraus.

Temporär vs. dauerhaft

Ein Schlüsselsatz mit export (Linux/macOS) oder set (Windows) gilt nur für die aktuelle Terminalsitzung und ist weg, wenn Sie sie schließen. Das ist für einen schnellen Test in Ordnung. Um den Schlüssel sitzungsübergreifend beizubehalten, legen Sie ihn wie unten gezeigt dauerhaft fest und öffnen Sie dann ein neues Terminal, damit die Änderung wirksam wird.
Lies den Schlüssel in deinem Code aus der Umgebung wieder ein:

Die Variable ist gesetzt, aber der Code kann sie trotzdem nicht finden

Ein Schlüssel, der mit export oder $env: gilt nur in der Terminal-Sitzung, in der du ihn ausgeführt hast. Ein neues Terminal oder ein neuer Tab übernimmt ihn nicht. Lege den Schlüssel dauerhaft fest (>> ~/.zshrc, setx), oder wiederholen Sie die export/$env: Zeile in der Sitzung, die Sie verwenden.
Eine dauerhafte Änderung (Shell-Profil, setx) gilt für Terminals, die nach der Änderung gestartet werden. Öffnen Sie ein neues Terminal und starten Sie Ihre IDE oder Ihren Editor neu, damit diese die neue Umgebung übernimmt. Unter Windows, setx wirkt sich nicht auf Terminals aus, die bereits geöffnet sind.
Prozesse, die von systemd, supervisor, Docker oder ein CI-Runner lesen Ihr interaktives Shell-Profil nicht. Setzen Sie die Variable in der eigenen Konfiguration des Dienstes (zum Beispiel in einer systemd der Einheit Environment=, ein docker run -e Flag, oder die Secrets des CI-Projekts), nicht in ~/.bashrc.
sudo gibt deine Umgebung standardmäßig nicht weiter, daher ist die Variable, die du als dein Benutzer exportiert hast, für den Prozess mit erhöhten Rechten nicht sichtbar. Verwende sudo -E um die Umgebung beizubehalten, oder legen Sie die Variable innerhalb des erhöhten Kontexts fest.

Verwandte Themen

Zuletzt geändert am 10. August 2026