> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-f533effe.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Schlüssel generieren

> Erstellen Sie einen Venice-API-Schlüssel im Dashboard, speichern Sie den Bearer-Token sicher und verifizieren Sie ihn per Chat-Completions-Anfrage.

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.

<Note>
  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](/guides/integrations/generating-api-key-agent).
</Note>

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

<Steps>
  <Step title="API-Einstellungen öffnen">
    Rufen Sie [https://venice.ai/settings/api](https://venice.ai/settings/api?utm_source=venice-api-documentation) 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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Schlüssel generieren und kopieren">
    Klicken Sie auf **Generate**. Venice zeigt den vollständigen API-Schlüssel einmalig an.

    <Warning>
      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.
    </Warning>

    Fügen Sie den Schlüssel zu Ihrer lokalen Umgebung oder Ihrem Secret-Manager hinzu:

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Schlüssel verifizieren">
    Stellen Sie eine risikoarme Anfrage, um zu bestätigen, dass die Authentifizierung funktioniert:

    ```bash theme={null}
    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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## 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](/api-reference/endpoint/api_keys/rate_limits) 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](https://venice.ai/settings/api?utm_source=venice-api-documentation), oder rufen Sie [API-Schlüssel aktualisieren](/api-reference/endpoint/api_keys/update) 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](/api-reference/error-codes) 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:

<CardGroup cols={2}>
  <Card title="API-Schlüssel erstellen" icon="plus" href="/api-reference/endpoint/api_keys/create">
    Erstellen Sie einen neuen API-Schlüssel im Dashboard-Stil aus einem vorhandenen Admin-Schlüssel.
  </Card>

  <Card title="API-Schlüssel auflisten" icon="list" href="/api-reference/endpoint/api_keys/list">
    Zeigen Sie aktive Schlüssel und ihre Metadaten an.
  </Card>

  <Card title="API-Schlüssel aktualisieren" icon="pen-to-square" href="/api-reference/endpoint/api_keys/update">
    Aktualisieren Sie eine Schlüsselbeschreibung, das Ablaufdatum oder die Verbrauchslimits.
  </Card>

  <Card title="API-Schlüssel löschen" icon="trash" href="/api-reference/endpoint/api_keys/delete">
    Widerrufen Sie einen Schlüssel, der nicht mehr benötigt wird.
  </Card>
</CardGroup>