> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modellzugriff für API-Schlüssel

Der Modellzugriff steuert, welche Modelle ein einzelner API-Schlüssel aufrufen kann. Er ändert nicht den aktivierten Modellbereich Ihres Teams – er schränkt innerhalb dieses Bereichs lediglich die Menge der Modelle ein, die ein bestimmter Schlüssel aufrufen darf. Aufrufe von Modellen außerhalb des Zugriffsbereichs eines Schlüssels werden abgelehnt.

<Info>
  Diese Funktion umfasst Modelle der LLM-Produktlinie. Eigenständige multimodale Bild- und Videofunktionen sind derzeit nicht Teil der Modellzugriffskonfiguration.
</Info>

Häufige Anwendungsfälle:

* **Schlüssel nach Zweck isolieren**: Produktionsschlüssel dürfen nur stabile Modelle erreichen, während experimentelle Schlüssel nur kostengünstige Modelle erreichen dürfen.
* **Risiken schnell eindämmen**: Wenn ein Schlüssel unerwartete Aufrufe kostenintensiver Modelle auslöst, beschränken Sie ihn auf einige sichere Modelle.
* **Externe Zusammenarbeit**: Geben Sie bei Schlüsseln, die mit Auftragnehmern oder Partnern geteilt werden, nur die vereinbarten Modelle frei.

## Zugriffsmodi

Jeder API-Schlüssel hat einen von zwei Zugriffsmodi:

| Zugriffsmodus            | Bedeutung                                                                                                                                                                                                                                                                                   |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Alle aktivierten Modelle | Standardmodus. Der Schlüssel kann auf alle Modelle zugreifen, die Ihr Team derzeit aktiviert hat, sowie auf Modelle, die in Zukunft aktiviert werden, und Sie können bestimmte Modelle ausschließen. Künftig aktivierte Modelle bleiben zugänglich, sofern sie nicht ausgeschlossen werden. |
| Nur ausgewählte Modelle  | Der Schlüssel kann nur auf die Modelle zugreifen, die Sie auswählen. Modelle, die Ihr Team später aktiviert, werden nicht automatisch hinzugefügt – Sie müssen sie selbst hinzufügen.                                                                                                       |

In beiden Modi überschreiten die zugänglichen Modelle niemals den aktivierten Modellbereich Ihres Teams und enthalten niemals Modelle, die offline genommen wurden.

* Alle aktivierten Modelle: zugängliche Modelle = aktivierte Modelle des Teams (einschließlich zukünftiger Modelle) − ausgeschlossene Modelle.
* Nur ausgewählte Modelle: zugängliche Modelle = ausgewählte Modelle (geschnitten mit den aktivierten Modellen des Teams).

## Modellzugriff konfigurieren

<Note>
  Nur Teamadmins können den Modellzugriff für einen API-Schlüssel konfigurieren. Developer- und Basic-Mitglieder sehen eine schreibgeschützte Zusammenfassung für Schlüssel, auf die sie zugreifen können, können sie aber nicht bearbeiten; Billing-Mitglieder sehen den Modellzugriff überhaupt nicht.
</Note>

<Steps>
  <Step title="Key Management öffnen">
    Gehen Sie zu [Key Management](https://novita.ai/settings/key-management) und suchen Sie den API-Schlüssel, den Sie konfigurieren möchten.
  </Step>

  <Step title="Modellzugriffseinstellungen öffnen">
    Öffnen Sie beim Erstellen oder Bearbeiten des Schlüssels den Abschnitt **Modellzugriff**.
  </Step>

  <Step title="Zugriffsmodus auswählen">
    Wählen Sie **Alle aktivierten Modelle** oder **Nur ausgewählte Modelle** aus:

    * Fügen Sie für **Alle aktivierten Modelle** unter **Ausgeschlossene Modelle** alle Modelle hinzu, die Sie blockieren möchten.
    * Fügen Sie für **Nur ausgewählte Modelle** unter **Zugängliche Modelle** mindestens ein Modell hinzu.
  </Step>

  <Step title="Speichern">
    Nachdem Sie gespeichert haben, kann es einige Zeit dauern, bis die neuen Modellzugriffseinstellungen wirksam werden.
  </Step>
</Steps>

<Tip>
  Wenn Sie einen neuen Schlüssel erstellen oder einen vorhandenen bearbeiten, können Sie mit **Konfiguration kopieren** und **Konfiguration einfügen** die Einstellungen eines anderen Schlüssels innerhalb desselben Teams wiederverwenden. Nach dem Einfügen können Sie direkt speichern oder zunächst Anpassungen vornehmen.
</Tip>

## Wenn ein Modell offline genommen wird

Wenn ein Modell von der Plattform offline genommen wird, verlässt es die Menge der verfügbaren Modelle:

* Alle Aufrufe dieses Modells geben sofort eine „Modell nicht verfügbar“-Antwort zurück.
* Wenn die gespeicherte Konfiguration eines Schlüssels das Offline-Modell noch enthält, bleibt es sichtbar, ist aber ausgegraut. Sie müssen es vor dem Speichern entfernen – andernfalls kann die Konfiguration nicht gespeichert werden.

## Wenn ein Aufruf abgelehnt wird

Wenn ein API-Schlüssel ein Modell außerhalb seines Zugriffsbereichs aufruft, gibt der Aufruf HTTP 403 mit dem Fehlercode `model_access_denied` zurück. Dies weist darauf hin, dass der Schlüssel nicht auf dieses Modell zugreifen kann. Wenden Sie sich an Ihren Teamadmin, um den Modellzugriff des Schlüssels anzupassen. Siehe auch [Häufige Fehlercodes](/docs/de/guides/error).

Informationen zum programmgesteuerten Verwalten des Modellzugriffs eines Schlüssels finden Sie unter [Modellzugriffsrichtlinie für API-Schlüssel abrufen](/docs/de/api-reference/key-get-model-access-policy).