> ## 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 ändern

> Ändere 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 ändern

`PATCH` akzeptiert `extraUsageEnabled`, `usageRequestsEnabled`, `workspaceExtraUsageLimit` und `defaultExtraUsageLimitPerPlan`. Schick mindestens eines davon. Ein Plan, den du in `defaultExtraUsageLimitPerPlan` weglässt, behält sein Limit.

```bash theme={null}
curl -X PATCH https://api.langdock.com/billing/v1/ai-models-included/settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"defaultExtraUsageLimitPerPlan":{"business_max":{"type":"limited","amount":150}}}'
```

Die Antwort entspricht `GET`, mit `extraUsagePeriodSpend` auf `null`. Lies die Einstellungen danach erneut, um die Ausgaben zu bekommen.

Ein begrenztes `workspaceExtraUsageLimit` muss größer als null sein. Ein begrenztes Plan-Standardlimit darf null sein.

Schaltest du `extraUsageEnabled` aus, ist das effektive Extra-Nutzungslimit jedes Mitglieds null. Die gespeicherten Limits bleiben. Ein unbegrenztes Limit eines Mitglieds oder einer Gruppe hebt diesen Schalter und das Workspace-Limit nicht auf.

> [!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.