API-Schlüssel

Ein API-Schlüssel authentifiziert Anfragen an Novita AI. Diese Seite erklärt, wie Sie einen Schlüssel erstellen und speichern, ihn in verschiedenen Umgebungen verwenden und seine Zugriffssteuerungen konfigurieren. Auf dieser Seite erfahren Sie, wie Sie:

Anfragen an Novita AI mit einem Bearer-API-Schlüssel authentifizieren.
einen API-Schlüssel in der Konsole erstellen und sicher speichern.
den Schlüssel als Umgebungsvariable unter Linux, macOS oder Windows festlegen.
prüfen, wie lange ein Schlüssel gültig bleibt und welche Schlüsselvorgänge die OpenAPI unterstützt.
Modell- und Netzwerkzugriffsrichtlinien für einen Schlüssel konfigurieren.

Authentifizierung

Novita AI verwendet die Bearer-Authentifizierung für den API-Zugriff. Senden Sie Ihren API-Schlüssel im Authorization-Anfrage-Header:

Authorization: Bearer <API Key>

Eine Beispielanfrage:

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

API-Schlüssel erstellen

Schlüsselverwaltung öffnen

Gehen Sie in der Konsole zu Schlüsselverwaltung.

Neuen Schlüssel erstellen

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

Schlüssel kopieren und speichern

Der vollständige Schlüssel wird nur einmal angezeigt, und zwar bei seiner Erstellung. Kopieren Sie ihn sofort und bewahren Sie ihn an einem sicheren Ort auf, z. B. in einem Secrets Manager oder in einer Umgebungsvariablen. Wenn Sie ihn verlieren, können Sie ihn nicht wiederherstellen; erstellen Sie stattdessen einen neuen Schlüssel.

Zugriffssteuerungen konfigurieren

Zugriffssteuerungen sind optional und werden pro API-Schlüssel konfiguriert:

Modellzugriff für API-Schlüssel steuert, welche Modelle ein Schlüssel innerhalb des für Ihr Team aktivierten Modellbereichs aufrufen kann.
Netzwerkzugriff für API-Schlüssel steuert, welche Quell-IPs einen Schlüssel für den Modellaufruf verwenden können.

Die speziellen Anleitungen erklären Richtlinienverhalten, Berechtigungen, Konfiguration und Ablehnungsfehler.

Schlüsselformat und Gültigkeit

Jeder Schlüssel beginnt mit dem Präfix sk_.
Ein Schlüssel wird nur einmal vollständig angezeigt, und zwar bei seiner Erstellung. Danach zeigt die Konsole eine maskierte Form.
Jedes Konto kann bis zu 10 API-Schlüssel erstellen.

Wenn Sie einen Schlüssel erstellen, wählen Sie eine von vier Ablaufoptionen: Dauerhaft / 90 Tage / 30 Tage / 24 Stunden.

Sie legen den Ablauf beim Erstellen des Schlüssels fest. Er kann danach nicht geändert werden: Sie können einen Schlüssel weder verlängern noch sofort ablaufen lassen. Dauerhafte Schlüssel bleiben unbegrenzt gültig, daher bleibt ein geleakter Schlüssel länger verwendbar. Verwenden Sie dauerhafte Schlüssel nur, wenn es angemessen ist. Der Ablauf wird nur in der Konsole konfiguriert; die OpenAPI erstellt keine Schlüssel und legt deren Ablauf nicht fest, ändert ihn nicht und entfernt ihn nicht.

Ein abgelaufener Schlüssel wird bei Verwendung abgelehnt, aber seine Konfiguration bleibt sichtbar und die Löschaktion ist weiterhin verfügbar. Der Ablauf unterscheidet sich vom Deaktivieren eines Schlüssels. Um den Zugriff wiederherzustellen, erstellen Sie einen neuen Schlüssel. Um einen Schlüssel vor seinem Ablauf zu deaktivieren, löschen Sie ihn in der Konsole; die Löschung wird sofort wirksam.

Was die OpenAPI abdeckt

Sie erstellen und löschen API-Schlüssel nur in der Konsole. Die Novita OpenAPI hat keine Endpunkte zum Erstellen oder Löschen von Schlüsseln und unterstützt das Konfigurieren des Ablaufs eines Schlüssels nicht. Die schlüsselbezogenen OpenAPI-Endpunkte ermöglichen es Ihnen, Schlüssel aufzulisten und ihre Modell- und Netzwerkzugriffsrichtlinien zu verwalten:

API-Schlüssel auflisten — listet die Schlüssel in Ihrem Team auf, mit einer optionalen Zusammenfassung des Modellzugriffs.
Modellzugriffsrichtlinie für API-Schlüssel abrufen — liest die Modellzugriffsrichtlinie eines einzelnen Schlüssels.
Modellzugriffsrichtlinie für API-Schlüssel festlegen — legt die Modellzugriffsrichtlinie eines Schlüssels fest oder aktualisiert sie.
Modellzugriffsrichtlinie für API-Schlüssel zurücksetzen — setzt die Modellzugriffsrichtlinie eines Schlüssels auf die Standardeinstellung zurück. Dies setzt nur die Richtlinie zurück; der Schlüssel selbst wird nicht gelöscht.
IP-Zugriffsrichtlinie für API-Schlüssel abrufen — liest die Netzwerkzugriffsrichtlinie eines einzelnen Schlüssels.
IP-Zugriffsrichtlinie für API-Schlüssel festlegen — legt die erlaubten Quell-IPs eines Schlüssels fest oder aktualisiert sie.
IP-Zugriffsrichtlinie für API-Schlüssel löschen — löscht die Netzwerkzugriffsrichtlinie eines Schlüssels, sodass keine Quell-IP-Beschränkung mehr gilt.

Schlüssel als Umgebungsvariable speichern

Wenn Sie einen Schlüssel im Quellcode fest codieren, kann er offengelegt werden, beispielsweise wenn Sie die Datei committen. Wenn Sie ihn aus einer Umgebungsvariablen wie NOVITA_API_KEY lesen, bleibt er aus Ihrem Quellcode heraus.

Temporär vs. dauerhaft

Ein Schlüssel, der mit export (Linux/macOS) oder set (Windows) festgelegt wurde, gilt nur für die aktuelle Terminalsitzung und ist verschwunden, wenn Sie sie schließen. Das eignet sich für einen schnellen Test. 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.

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.bashrc
source ~/.bashrc

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
# Newer macOS uses zsh (~/.zshrc); older setups use bash (~/.bash_profile)
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.zshrc
source ~/.zshrc

# Temporary: current PowerShell session only
$env:NOVITA_API_KEY = "<Your API Key>"

# Permanent: persist for the current user, then open a new terminal
setx NOVITA_API_KEY "<Your API Key>"

Lesen Sie den Schlüssel in Ihrem Code aus der Umgebung:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ.get("NOVITA_API_KEY"),
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.novita.ai/openai",
  apiKey: process.env.NOVITA_API_KEY,
});

Die Variable ist festgelegt, aber der Code findet sie immer noch nicht

Sie haben ihn temporär festgelegt und ein neues Terminal geöffnet

Ein Schlüssel, der mit export oder $env: festgelegt wurde, existiert nur in der Terminalsitzung, in der Sie den Befehl ausgeführt haben. Ein neues Terminal oder ein neuer Tab erbt ihn nicht. Legen Sie den Schlüssel dauerhaft fest (>> ~/.zshrc, setx), oder führen Sie den Befehl export/$env: erneut in der Sitzung aus, die Sie verwenden.

Sie haben ihn dauerhaft festgelegt, aber nicht neu gestartet

Eine dauerhafte Änderung (ein Shell-Profil oder setx) gilt für Terminals, die nach der Änderung gestartet wurden. Öffnen Sie ein neues Terminal und starten Sie dann Ihre IDE oder Ihren Editor neu, damit sie die aktualisierte Umgebung lesen können. Unter Windows wirkt sich setx nicht auf Terminals aus, die bereits geöffnet sind.

Ein Dienstmanager erbt Ihre Shell-Umgebung nicht

Von systemd, supervisor, Docker oder einem CI-Runner gestartete Prozesse lesen Ihr interaktives Shell-Profil nicht. Legen Sie die Variable in der eigenen Konfiguration des Dienstes fest, z. B. in einer systemd-Unit Environment=, in einem docker run -e-Flag oder in den Secrets des CI-Projekts, und nicht in ~/.bashrc.

Sie haben den Befehl unter sudo ausgeführt

sudo übergibt Ihre Umgebung standardmäßig nicht, daher ist eine Variable, die von Ihrem Benutzer exportiert wurde, für den erhöhten Prozess nicht sichtbar. Verwenden Sie sudo -E, um die Umgebung beizubehalten, oder legen Sie die Variable im erhöhten Kontext fest.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Authentifizierung

API-Schlüssel erstellen

Zugriffssteuerungen konfigurieren

Schlüsselformat und Gültigkeit

Was die OpenAPI abdeckt

Schlüssel als Umgebungsvariable speichern

Temporär vs. dauerhaft

Die Variable ist festgelegt, aber der Code findet sie immer noch nicht

Verwandte Themen

​Authentifizierung

​API-Schlüssel erstellen

​Zugriffssteuerungen konfigurieren

​Schlüsselformat und Gültigkeit

​Was die OpenAPI abdeckt

​Schlüssel als Umgebungsvariable speichern

​Temporär vs. dauerhaft

​Die Variable ist festgelegt, aber der Code findet sie immer noch nicht

​Verwandte Themen

Authentifizierung

API-Schlüssel erstellen

Zugriffssteuerungen konfigurieren

Schlüsselformat und Gültigkeit

Was die OpenAPI abdeckt

Schlüssel als Umgebungsvariable speichern

Temporär vs. dauerhaft

Die Variable ist festgelegt, aber der Code findet sie immer noch nicht

Verwandte Themen