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

# Extra-Nutzung: Einstellungen abrufen

> Lies Extra-Nutzung, Nutzungslimit-Anfragen, das Workspace-Limit und das Standardlimit je Plan

Lies und ändere die Extra-Nutzung für den Modus `ai-models-included`. Beträge sind Euro.

Der Aufruf nutzt den `BILLING_API` Scope des Workspace-API-Schlüssels. Schreibzugriffe laufen als der Service Account, dem der Schlüssel gehört.

> [!NOTE]
>
> Diese Routen gelten, wenn `GET /billing/v1/mode` den Modus `ai-models-included` liefert. Ein Dedicated Deployment liefert immer `bring-your-own-keys`, auch wenn Langdock die Modellschlüssel verwaltet. Der andere Modus antwortet mit `409` und `code` `BILLING_MODE_MISMATCH`.

## Basis-URL

```
https://api.langdock.com/billing/v1/ai-models-included/settings
```

## Voraussetzungen

* **API-Schlüssel** mit dem Scope `BILLING_API`
* Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat

## Einstellungen lesen

`GET /billing/v1/ai-models-included/settings` liefert die aktuellen Einstellungen.

```json theme={null}
{
  "currency": "EUR",
  "extraUsageEnabled": true,
  "usageRequestsEnabled": true,
  "workspaceExtraUsageLimit": { "type": "limited", "amount": 2000 },
  "defaultExtraUsageLimitPerPlan": {
    "business": { "type": "limited", "amount": 50 },
    "business_max": { "type": "limited", "amount": 150 }
  },
  "extraUsagePeriod": {
    "start": "2026-09-01T00:00:00.000Z",
    "end": "2026-10-01T00:00:00.000Z"
  },
  "extraUsagePeriodSpend": 412.35
}
```

`extraUsageEnabled` schaltet die Extra-Nutzung für den Workspace an oder aus. Ist sie aus, ist das effektive Extra-Nutzungslimit jedes Mitglieds null, mit `source` `workspace`. Gespeicherte Limits von Mitgliedern und Gruppen bleiben, bis du die Extra-Nutzung wieder einschaltest.

`workspaceExtraUsageLimit` deckelt die Extra-Nutzung in `extraUsagePeriod`. Chat-, Agenten- und persönliche API-Key-Nutzung zählen auf dieses Limit, ebenso Agent-API-Aufrufe mit einem Workspace-Schlüssel, wenn das Agent-Budget `always` mit einem begrenzten Betrag ist. Andere Workspace-API-Nutzung, Workflow-Ausführungen und die Nutzung eigener Modelle zählen nicht mit. Siehe [Extra-Nutzung](https://docs.langdock.com/de/admin/manage-usage/extra-usage.md). Ein unbegrenztes Limit eines Mitglieds oder einer Gruppe hebt es nicht auf. `extraUsagePeriodSpend` ist die Nutzung, die gegen das Limit zählt. Der Wert ist `null`, wenn der Workspace die Ausgaben pro Nutzer ausblendet.

`defaultExtraUsageLimitPerPlan` ist das Standard-Extra-Nutzungslimit für **Business** (`business`) und **Business Max** (`business_max`). Ein Mitglied mit `inherit` nutzt diese Vorgaben zusammen mit den Gruppenlimits. Siehe [Extra-Nutzung: Nutzer abrufen](https://docs.langdock.com/de/developer/billing-api/get-included-user.md).

`usageRequestsEnabled` erlaubt Mitgliedern, bei einem Admin mehr Nutzung anzufragen.

> [!NOTE]
>
> Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](https://docs.langdock.com/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.