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

# Budgets

Die Seite **Budgets** ermöglicht es Ihnen, Ausgabenlimits für Teammitglieder und einzelne API-Schlüssel festzulegen und zu verwalten. So erhalten Sie eine fein abgestufte Kontrolle über die Kosten über alle Service-Stufen hinweg.

<Note>
  Diese Funktion ist nur für Teamkonten verfügbar. Persönliche Konten oder Konten, die nicht Teil eines Teams sind, können das Menü sehen, aber nicht auf die Budgetverwaltung zugreifen. Sie können Ihr persönliches Konto über die Seite [**Team-Einstellungen**](https://novita.ai/settings/team) in ein Teamkonto umwandeln oder einem bestehenden Team beitreten.
</Note>

## Berechtigungen

* Die Rollen **Team Owner**, **Admin** und **Billing** können Budgets für alle Teammitglieder und deren API-Schlüssel anzeigen und ändern.
* Die Rollen **Developer** und **Basic** können nur ihren eigenen Budgettyp und ihre eigenen Limits anzeigen (einschließlich ihrer API-Schlüssel). Sie können keine Änderungen vornehmen.

## Mitgliedsbudgets und API-Schlüssel-Budgets

Sie können Ausgaben auf zwei Ebenen steuern:

* **Mitgliedsbudget**: Eine Obergrenze für alles, was ein Mitglied über alle Services hinweg ausgibt (LLM API, GPU-Instanzen, Sandbox usw.)
* **API-Schlüssel-Budget**: Eine separate Ausgabenobergrenze nur für die LLM API-Nutzung dieses Schlüssels. GPU-Instanzen, Sandbox und andere Services werden nicht auf Schlüsselbudgets angerechnet, zählen aber zum Mitgliedsbudget.

**Beide Limits werden gleichzeitig durchgesetzt — maßgeblich ist das Limit, das zuerst erreicht wird:**

* Das Budget eines Schlüssels ist aufgebraucht → dieser Schlüssel wird pausiert; die anderen Schlüssel des Mitglieds und GPU-Services sind nicht betroffen.
* Das Budget des Mitglieds ist aufgebraucht → alle Services dieses Mitglieds werden pausiert. Bei GPU-Instanzen und anderen zeitbasiert abgerechneten Produkten können keine neuen Ressourcen erstellt werden; bestehende Ressourcen laufen bis zum Ende ihres Abrechnungszyklus weiter.

## Budgettypen

Sowohl Mitgliedsbudgets als auch API-Schlüssel-Budgets unterstützen dieselben drei Typen und können unabhängig voneinander konfiguriert werden:

| Typ                | Beschreibung                                                                    | Zurücksetzungsverhalten                                                                                            |
| ------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Unbegrenzt         | Keine Ausgabenobergrenze. Die Nutzung wird weiterhin für Berichte erfasst.      | Keine                                                                                                              |
| Festes Budget      | Ein einmaliges Gesamtlimit. Services werden pausiert, wenn es aufgebraucht ist. | Wird nicht zurückgesetzt. Ein Admin muss das Limit manuell erhöhen, um die Nutzung fortzusetzen.                   |
| Monatliches Budget | Ein Limit pro Monat. Services werden pausiert, wenn es aufgebraucht ist.        | Wird automatisch um 00:00 UTC am 1. jedes Monats zurückgesetzt. Nicht verbrauchtes Guthaben wird nicht übertragen. |

**Beispiele für Typkombinationen:**

* Mitglied: Monatlich \$500 + Schlüssel: Monatlich \$100 → Standardmäßige zweistufige Kontrolle
* Mitglied: Unbegrenzt + Schlüssel: Monatlich \$50 → Dem Mitglied insgesamt vertrauen, aber einen öffentlich verwendeten Schlüssel begrenzen
* Mitglied: Monatlich \$500 + Schlüssel: Festes Budget \$200 → Der Schlüssel ist für ein Projekt mit einem definierten Gesamtbudget vorgesehen

### „Nicht festgelegt“ vs. „Unbegrenzt“

* **Nicht festgelegt**: Für dieses Mitglied / diesen Schlüssel wurde noch kein Budget konfiguriert. Admins sollten dies festlegen, um einen blinden Fleck in der Verwaltung zu vermeiden.
* **Unbegrenzt**: Der Admin hat sich bewusst dafür entschieden, kein Limit festzulegen. Regelmäßig überprüfen.

## Budgettypen wechseln

Beim Ändern eines Budgettyps wendet das System die folgenden Regeln auf bestehende Nutzung und Zurücksetzungszyklen an:

| Wechselrichtung                    | Verbrauchter Betrag                                                                                                           | Zurücksetzungsverhalten                                   |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Unbegrenzt → Festes Budget         | Beginnt bei \$0. Frühere Nutzung wird nicht übertragen.                                                                       | Keine Zurücksetzung.                                      |
| Festes Budget → Monatliches Budget | Historische Nutzung wird beibehalten und angezeigt. Die neue monatliche Nachverfolgung beginnt ab dem Zeitpunkt des Wechsels. | Erste monatliche Zurücksetzung am 1. des nächsten Monats. |
| Monatliches Budget → Festes Budget | Der aktuell verbrauchte Betrag wird beibehalten. Die monatliche Zurücksetzung endet.                                          | Keine weiteren Zurücksetzungen.                           |
| Beliebig → Unbegrenzt              | Die Budgetkonfiguration wird gelöscht.                                                                                        | Sofort uneingeschränkt.                                   |

## Details zu monatlichen Budgets

### Automatische Zurücksetzung

Monatliche Budgets werden um **00:00 UTC am 1. jedes Monats** zurückgesetzt: Der verbrauchte Betrag wird auf null gesetzt und das volle Limit wiederhergestellt. **Nicht verbrauchtes Guthaben wird nicht in den nächsten Monat übertragen.**

### Monatliche Limits anpassen

Admins können das monatliche Limit jederzeit aktualisieren. Änderungen werden sofort wirksam. Verbleibendes Guthaben = neues Limit − Betrag, der in diesem Monat bereits verbraucht wurde.

Häufige Szenarien:

* **Limit erhöhen**: Das verfügbare Guthaben erhöht sich sofort. Wenn Services pausiert waren, werden sie sofort fortgesetzt.
* **Limit senken**: Das verfügbare Guthaben sinkt. Wenn das neue Limit unter dem bereits verbrauchten Betrag liegt, werden Services sofort pausiert und erst fortgesetzt, sobald das Limit wieder erhöht wird.
* **Festes Budget — mehr Kontingent hinzufügen**: Erhöhen Sie das Budgetlimit direkt. Eine manuelle Zurücksetzung des verbrauchten Betrags wird nicht unterstützt.

## Mitgliedsbudgets festlegen

1. Gehen Sie zur Seite [**Budgets**](https://novita.ai/billing/budgets). Suchen Sie das Zielmitglied in der Liste oder verwenden Sie das Suchfeld.

   <img src="https://mintcdn.com/novitaai/H3Kjvdvlhgt0Aohj/guides/images/Budges01.png?fit=max&auto=format&n=H3Kjvdvlhgt0Aohj&q=85&s=c7df2a97caf5dfbe4a16cdaf30f4427b" alt="Budges01 Pn" width="1280" height="829" data-path="guides/images/Budges01.png" />

2. Klicken Sie auf **Bearbeiten**, wählen Sie einen Budgettyp aus und geben Sie den Limitbetrag ein.

   * Neue Mitglieder sind standardmäßig auf **Unbegrenzt** gesetzt. Dies kann jederzeit geändert werden.
   * Die Typen **Festes Budget** und **Monatliches Budget** erfordern einen bestimmten Betrag.

   <img src="https://mintcdn.com/novitaai/H3Kjvdvlhgt0Aohj/guides/images/Budges02.png?fit=max&auto=format&n=H3Kjvdvlhgt0Aohj&q=85&s=05736cda09f305ecbe2d59cc4c0cc4ab" alt="Budges02 Pn" width="1280" height="827" data-path="guides/images/Budges02.png" />

3. Klicken Sie auf **Aktualisieren**, um die neuesten Budget- und Nutzungsdaten zu laden.

   <img src="https://mintcdn.com/novitaai/H3Kjvdvlhgt0Aohj/guides/images/Budges03.png?fit=max&auto=format&n=H3Kjvdvlhgt0Aohj&q=85&s=779bca0d1f3a71c0d73945756120b92e" alt="Budges03 Pn" width="1280" height="829" data-path="guides/images/Budges03.png" />

<Warning>
  Budgetänderungen werden sofort wirksam. Sobald das Kontingent eines Mitglieds aufgebraucht ist, kann es keine neuen Serviceaufrufe starten. Bestätigen Sie das Limit vor dem Speichern.
</Warning>

## API-Schlüssel-Budgets festlegen

**Primärer Einstieg:** Gehen Sie zur Seite [**Budgets**](https://novita.ai/billing/budgets) und klicken Sie in einer Mitgliederzeile auf **API-Schlüssel anzeigen**. Ein Bereich wird geöffnet, der alle Schlüssel dieses Mitglieds anzeigt. Dort können Sie deren Budgets ansehen und bearbeiten.

**Sekundärer Einstieg:** Gehen Sie zu **LLM API → API-Schlüssel**. Budgetstatus-Labels werden in der Schlüsselliste angezeigt. Klicken Sie auf die Details eines Schlüssels, um zur Konfiguration auf die Budgets-Seite weitergeleitet zu werden.

API-Schlüssel-Budgets unterstützen dieselben drei Typen wie Mitgliedsbudgets (Unbegrenzt / Festes Budget / Monatliches Budget) und werden auf dieselbe Weise konfiguriert.

<Note>
  API-Schlüssel-Budgets gelten nur für die LLM API-Nutzung. GPU-Instanzen, Sandbox und andere Services unterliegen nicht den Limits für Schlüsselbudgets, ihre Kosten zählen jedoch weiterhin zum Gesamtbudget des Mitglieds.
</Note>

<Note>
  Wenn ein API-Schlüssel gelöscht wird, wird seine Budgetkonfiguration automatisch archiviert. Historische Nutzungsdatensätze werden beibehalten und bleiben zugänglich.
</Note>

## Budgetlimit erreicht

Wenn ein Budget aufgebraucht ist, zeigen sowohl das Dashboard als auch API-Antworten an, welche Budgetebene erreicht wurde:

* **Mitgliedsbudget aufgebraucht**: „Ihr Mitgliedsbudget hat sein Limit erreicht (\$200 / \$200). Alle Services sind pausiert. Bitte kontaktieren Sie Ihren Admin, um eine Anpassung vorzunehmen.“
* **API-Schlüssel-Budget aufgebraucht**: „API-Schlüssel your-key-name hat sein Budgetlimit erreicht (\$50 / \$50). Andere Schlüssel sind nicht betroffen.“
* **Beide Limits gleichzeitig erreicht**: Die Meldung auf Schlüsselebene wird zuerst angezeigt, wobei der Status des Mitgliedsbudgets als zusätzlicher Kontext enthalten ist.

Admins können das Limit erhöhen oder den Budgettyp direkt auf der Budgets-Seite wechseln. Änderungen werden sofort wirksam.
