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 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:
Eine erfolgreiche Antwort liefert die verfügbaren Modelle zurück. Wenn Sie einen Authentifizierungsfehler erhalten, überprüfen Sie, ob der Schlüssel vollständig kopiert wurde und ob der Authorization-Header im Format Bearer <api-key> vorliegt.
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.