Zum Hauptinhalt springen
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:
export VENICE_API_KEY="your-api-key-here"
4

Schlüssel verifizieren

Stellen Sie eine risikoarme Anfrage, um zu bestätigen, dass die Authentifizierung funktioniert:
curl --request GET \
  --url https://api.venice.ai/api/v1/models \
  --header "Authorization: Bearer $VENICE_API_KEY"
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.

​
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.