Skip to main content
Venice-API-Anfragen werden mit Bearer-API-Schlüsseln authentifiziert. Diese Anleitung zeigt, wie Sie einen Schlüssel über das Venice-Dashboard erstellen, sicher aufbewahren und seine Funktion überprüfen.
Wenn Sie einen autonomen Agenten entwickeln, der seinen eigenen Schlüssel mit einer Wallet erstellen muss, verwenden Sie stattdessen die Anleitung Erstellung von API-Schlüsseln für autonome Agenten.

​
Bevor Sie beginnen

  • Melden Sie sich bei Ihrem Venice-Konto an.
  • Stellen Sie sicher, dass das Konto über ein verfügbares Guthaben verfügt, bevor Sie kostenpflichtige Endpunkte aufrufen. Sie können einen Schlüssel erstellen, bevor Sie das Konto aufladen, aber Modellanfragen sind erst dann erfolgreich, wenn das Konto DIEM, gebündelte Credits oder USD verbrauchen kann.
1

API-Einstellungen öffnen

Rufen Sie https://venice.ai/settings/api auf. Sie können diese Seite auch in der Venice-App öffnen, indem Sie in Ihren Einstellungen API auswählen.Das API-Einstellungs-Dashboard zeigt Ihre Guthaben, Ihre API-Stufe, die Nutzung und vorhandene API-Schlüssel an.
2

Neuen Schlüssel starten

Wählen Sie Generate New API Key und konfigurieren Sie anschließend den Schlüssel:
  • Description: Verwenden Sie einen kurzen Namen, der die App, die Umgebung oder die Integration identifiziert, die diesen Schlüssel verwenden wird.
  • API Key Type: Verwenden Sie Inference Only für normale Modellanfragen. Verwenden Sie Admin nur dann, wenn der Schlüssel API-Schlüssel programmgesteuert verwalten soll.
  • Expires at: Legen Sie optional ein Ablaufdatum fest. Wenn Sie dieses Feld leer lassen, läuft der Schlüssel nicht automatisch ab.
  • Epoch Consumption Limits: Begrenzen Sie optional, wie viel DIEM oder USD dieser Schlüssel innerhalb einer 24-Stunden-Epoche ausgeben darf. Wenn Sie dieses Feld leer lassen, kann der Schlüssel das verfügbare Kontoguthaben im Rahmen Ihrer Kontolimits nutzen.
3

Schlüssel generieren und kopieren

Klicken Sie auf Generate. Venice zeigt den vollständigen API-Schlüssel einmalig an.
Kopieren Sie den Schlüssel sofort und bewahren Sie ihn an einem sicheren Ort auf. Nachdem Sie den Dialog geschlossen haben, zeigt Venice nur noch identifizierende Metadaten wie die Schlüsselbeschreibung und die letzten Zeichen an. Wenn Sie den geheimen Wert verlieren, löschen Sie den Schlüssel und erstellen Sie einen neuen.
Fügen Sie den Schlüssel genau so ein, wie er ausgegeben wurde. Verwenden Sie die Kopierschaltfläche des Dialogs, statt den Text von Hand zu markieren, damit Sie weder das erste noch das letzte Zeichen abschneiden oder einen abschließenden Zeilenumbruch mitkopieren. Wenn ein Tool den Schlüssel in einem Formularfeld abfragt, geben Sie nur den Schlüssel selbst ein: kein Bearer-Präfix, keine umschließenden Anführungszeichen und keine führenden oder abschließenden Leerzeichen. Da das Dashboard nach dem Schließen des Dialogs nur noch die letzten Zeichen anzeigt, sollten Sie niemals versuchen, einen verlorenen Schlüssel durch Abtippen dieses maskierten Werts zu rekonstruieren.Fügen Sie den Schlüssel zu Ihrer lokalen Umgebung oder Ihrem Secret-Manager hinzu:
4

Schlüssel verifizieren

Stellen Sie eine risikoarme Anfrage, um zu bestätigen, dass die Authentifizierung funktioniert. Ratenlimits und Guthaben eines API-Schlüssels abrufen ist kostenlos und akzeptiert beide Schlüsseltypen. Verwenden Sie diesen Endpunkt statt GET /models, der den Modellkatalog mit oder ohne Schlüssel zurückgibt und daher auch dann erfolgreich ist, wenn Ihr Schlüssel falsch ist:
Eine erfolgreiche Antwort liefert Ihre API-Stufe, Ihre Guthaben und Ihre Ratenlimits zurück, und data.accessPermitted gibt an, ob der Schlüssel die Inferenz-Endpunkte nutzen darf.Ein 401 mit AUTHENTICATION_FAILED bedeutet, dass der Schlüssel selbst abgelehnt wurde. Geben Sie den gespeicherten Wert aus und vergleichen Sie ihn mit den letzten Zeichen, die im Dashboard angezeigt werden: Die üblichen Ursachen sind eine unvollständige Kopie, ein Bearer-Präfix oder Anführungszeichen, die in den Wert selbst übernommen wurden, oder ein überzähliges Leerzeichen bzw. ein Zeilenumbruch an einem der beiden Enden. Prüfen Sie außerdem, ob der Header Bearer <api-key> lautet, mit genau einem Leerzeichen zwischen den beiden Teilen.
Wenn Sie beim Erstellen eines API-Schlüssels in der Venice-App die USD-Ausgaben deaktivieren, wird das USD-Ausgabenlimit für den betreffenden API-Schlüssel auf null gesetzt. API-Aufrufe können mit einem Fehler wegen unzureichenden Guthabens fehlschlagen, wenn Ihr verfügbares DIEM- oder gebündeltes Guthaben die Anfrage nicht decken kann – selbst wenn Ihr Konto ein USD-Guthaben hat.

​
Fehlerbehebung bei Ausgabenlimit-Fehlern

Ausgabenlimits pro Schlüssel sind vom Guthaben Ihres Kontos getrennt. Ein Schlüssel kann von Ausgaben ausgeschlossen sein, selbst wenn Ihr Konto noch über aufgeladene USD-Credits, DIEM oder gebündelte Credits verfügt. Wenn eine Anfrage einen 402-Fehler mit einem der folgenden Codes zurückgibt, liegt die Ursache im Limit des Schlüssels selbst und nicht am Kontoguthaben:
  • API_KEY_USD_SPEND_LIMIT_EXCEEDED – Das USD-Ausgabenlimit des Schlüssels ist auf null gesetzt (USD-Ausgaben wurden bei der Erstellung deaktiviert), oder die aktuelle Epoche hat ihre USD-Obergrenze erreicht.
  • API_KEY_DIEM_SPEND_LIMIT_EXCEEDED – Der Schlüssel hat seine DIEM-Obergrenze für die aktuelle 24-Stunden-Epoche erreicht.
Um den aktuellen Status eines Schlüssels zu überprüfen, rufen Sie Ratenlimits und Guthaben eines API-Schlüssels abrufen auf und prüfen Sie data.accessPermitted, data.balances sowie die Verbrauchslimits pro Schlüssel. Um den Fehler zu beheben, erhöhen oder entfernen Sie entweder die Epoch Consumption Limits des Schlüssels unter venice.ai/settings/api, oder rufen Sie API-Schlüssel aktualisieren mit neuen consumptionLimits auf. Kontoweite Guthaben (USD, DIEM und gebündelte Credits) sind unabhängige Zahlungsquellen und werden automatisch nach Verfügbarkeit verbraucht; Sie müssen zum Zeitpunkt der Anfrage keine Auswahl treffen. Siehe Fehlercodes für die vollständige Liste der abrechnungsbezogenen Antworten.

​
Best Practices

  • Erstellen Sie separate Schlüssel für Entwicklung, Staging und Produktion.
  • Bevorzugen Sie Inference Only-Schlüssel für Anwendungen, die ausschließlich Modell-Endpunkte aufrufen.
  • Setzen Sie Admin-Schlüssel nur selten ein, beschränken Sie ihren Geltungsbereich strikt und speichern Sie sie ausschließlich in vertrauenswürdigen serverseitigen Umgebungen.
  • Speichern Sie API-Schlüssel niemals in der Versionskontrolle und geben Sie sie niemals in clientseitigem Code preis.
  • Legen Sie Ablaufdaten und Verbrauchslimits für Schlüssel fest, die in temporären, gemeinsam genutzten oder risikoreicheren Umgebungen verwendet werden.
  • Löschen Sie ungenutzte Schlüssel und rotieren Sie jeden Schlüssel, der möglicherweise offengelegt wurde.

​
Programmgesteuerte Schlüsselverwaltung

Admin-Schlüssel können API-Schlüssel über die Endpunkte der API-Referenz verwalten:

API-Schlüssel erstellen

Erstellen Sie einen neuen API-Schlüssel im Dashboard-Stil aus einem vorhandenen Admin-Schlüssel.

API-Schlüssel auflisten

Zeigen Sie aktive Schlüssel und ihre Metadaten an.

API-Schlüssel aktualisieren

Aktualisieren Sie eine Schlüsselbeschreibung, das Ablaufdatum oder die Verbrauchslimits.

API-Schlüssel löschen

Widerrufen Sie einen Schlüssel, der nicht mehr benötigt wird.