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

# DeepMask API

> Nutzen Sie DeepMask-Modelle in Ihren eigenen Anwendungen und Skripten über eine OpenAI-kompatible API mit Abrechnung nach Verbrauch.

Mit der DeepMask API rufen Sie DeepMask-Modelle aus Ihren eigenen Anwendungen, Skripten und Diensten auf. Die API ist OpenAI-kompatibel. Sie können daher die offiziellen OpenAI-SDKs verwenden und müssen nur die Basis-URL und den API-Schlüssel ändern. Administratoren Ihrer Organisation erstellen Schlüssel, legen fest, welche Modelle jeder Schlüssel nutzen darf, und verwalten die Abrechnung auf der Einstellungsseite **API**.

## Wer die API nutzen kann

| Wer | Voraussetzung |
| - | - |
| **Organisationen** | Ein aktiver kostenpflichtiger Chat-Tarif: Pro, Power oder Enterprise. Der kostenlose Tarif, kostenlose Testphasen und Tarife mit überfälliger Zahlung beinhalten keinen API-Zugriff. |
| **Administratoren der Organisation** | Die Administratorrolle. Administratoren verwalten Schlüssel, Modelle, Nutzung und Abrechnung auf der Einstellungsseite **API**. Siehe [Team-Management](https://documentation.deepmask.io/de/enterprise/team-management.md). |
| **Entwickler** | Ein API-Schlüssel von einem Administrator. Der Schlüssel allein authentifiziert jede Anfrage, daher benötigen Entwickler keine Administratorrechte. Rufen Sie die API von einem Server oder Skript aus auf. Browser blockieren Aufrufe von Webseiten aus, und ein Schlüssel darf nie in clientseitigem Code stehen. |

Um die API-Seite zu öffnen, klicken Sie unten in der Chat-Seitenleiste auf Ihren Namen, wählen Sie **Benutzereinstellungen** und klicken Sie in der Seitenleiste der Einstellungen auf **API**. Nur Administratoren der Organisation sehen **API**.

> [!NOTE]
>
> Schlüssel funktionieren nur, solange Ihre Organisation einen aktiven kostenpflichtigen Chat-Tarif hat und die API-Abrechnung aktiv ist. Schlägt die Zahlung einer API-Rechnung fehl, nimmt die API keine Anfragen mehr an, bis Sie die Rechnung bezahlt haben. Siehe [Abrechnung](https://documentation.deepmask.io/de/api/billing.md).

## Was Sie tun können

| Endpunkt | Funktion |
| - | - |
| `POST /v1/chat/completions` | Erzeugt eine Antwort auf eine Liste von Nachrichten. Unterstützt Streaming, Tool-Aufrufe mit Funktionen und bei ausgewählten Modellen Bildeingabe. |
| `GET /v1/models` | Listet die Modelle auf, die Ihr Schlüssel nutzen darf. |

* Nachrichten können die Rollen `system`, `user`, `assistant` und `tool` verwenden. Verwenden Sie `system` statt `developer`.
* In `system`- und `user`-Nachrichten kann `content` ein String oder ein Array aus Content-Parts sein. In `assistant`- und `tool`-Nachrichten muss `content` ein String sein. Eine Assistant-Nachricht mit Tool-Aufrufen darf `null` als `content` haben. Datei-, Audio- und Dokument-Parts lehnt die API ab. Die Regeln für jede Rolle finden Sie unter [Nachrichten](https://documentation.deepmask.io/de/api/chat-completions.md#nachrichten).
* Bei sieben Modellen, darunter `gpt-4o`, können Sie Bilder in `user`-Nachrichten als Base64-Data-URLs senden. Die API lehnt Bildlinks ab und ruft sie nie ab. Die Modelle, Formate und Limits finden Sie unter [Bildeingabe](https://documentation.deepmask.io/de/api/chat-completions.md#bildeingabe).
* Die API akzeptiert eine feste Auswahl an Anfragefeldern. Dazu gehören die Sampling-Optionen `temperature`, `top_p`, `presence_penalty`, `frequency_penalty`, `seed`, `stop` und `n` (nur mit dem Wert 1). Manche Modelle ignorieren einige dieser Optionen, ohne einen Fehler zurückzugeben. Siehe [Optionen, die manche Modelle ignorieren](https://documentation.deepmask.io/de/api/chat-completions.md#optionen-die-manche-modelle-ignorieren).
* Andere Felder wie `response_format`, `logprobs` und `reasoning_effort` lehnt die API mit einem `400`-Fehler ab. Denselben Fehler erhalten Sie für einen Wert außerhalb des zulässigen Bereichs eines Felds, etwa für `n` über 1. Die unterstützten Felder und ihre Wertebereiche finden Sie unter [Anfragetext](https://documentation.deepmask.io/de/api/chat-completions.md#anfragetext).
* Die Limits **Anfragen pro Minute**, **Tokens pro Minute** und **Gleichzeitige Anfragen** Ihrer Organisation gelten für alle Schlüssel zusammen. Administratoren sehen die aktuellen Werte unter **API-Limits** auf der Registerkarte **Nutzung**. Zusätzlich hat jeder Schlüssel eigene Limits für Anfragen pro Minute und für Anfragen in Bearbeitung. Anfragen, die ein Limit überschreiten, lehnt die API mit `429` ab. Unter [Limits und faire Nutzung](https://documentation.deepmask.io/de/api/limits.md) finden Sie alle Limits und erfahren, wie die faire Nutzung funktioniert.

> [!NOTE]
>
> Nur diese beiden Endpunkte sind verfügbar. Embeddings, Bilderzeugung, Legacy-Completions, die Responses API und das Abrufen eines einzelnen Modells mit `client.models.retrieve()` funktionieren nicht.

## Basis-URL und Authentifizierung

Senden Sie jede Anfrage an `https://api.deepmask.io/v1`. Sie können die URL unter **Basis-URL** oben auf der Einstellungsseite **API** kopieren.

Senden Sie Ihren Schlüssel im Header `Authorization` als `Bearer <key>`. Schlüssel beginnen mit `sk-`, gefolgt von 64 Hexadezimalzeichen. DeepMask zeigt den vollständigen Schlüssel nur einmal an, wenn Sie ihn erstellen.

Setzen Sie in den OpenAI-SDKs `base_url` (Python) bzw. `baseURL` (Node.js) auf `https://api.deepmask.io/v1`. Übergeben Sie Ihren Schlüssel als `api_key` bzw. `apiKey`. Das SDK sendet den Header dann automatisch.

## Erste Schritte

Ein Administrator öffnet die Einstellungsseite **API**, klickt auf der Registerkarte **Abrechnung** auf **API-Abrechnung aktivieren** und schließt den Checkout ab. Der Checkout fragt nach einer Zahlungsmethode und einer Rechnungsadresse. Anschließend klickt der Administrator auf der Registerkarte **Schlüssel** auf **Schlüssel erstellen**. **Schlüssel erstellen** ist erst verfügbar, wenn die API-Abrechnung aktiv ist.

Der [Schnellstart](https://documentation.deepmask.io/de/api/quickstart.md) führt Sie durch die Einrichtung und Ihre erste Anfrage mit cURL, Python und Node.js.

## Modelle und Hosting

Die API bietet Chat-Modelle von Anthropic, OpenAI, Mistral AI und weiteren Anbietern. Alle API-Modelle werden in der EU gehostet. Die Registerkarte **Modelle** zeigt den aktuellen Katalog.

Jeder Schlüssel kann nur die Modelle nutzen, die ein Administrator für ihn freigegeben hat. Verwenden Sie als Wert für `model` die **API-Modell-ID**, die auf der Registerkarte **Modelle** angezeigt wird, zum Beispiel `gpt-4o`. Fähigkeiten und Preise finden Sie unter [Modelle](https://documentation.deepmask.io/de/api/models.md).

## Abrechnung im Überblick

* **Getrennt vom Chat.** Die API-Abrechnung ist ein eigenes Abonnement nach Verbrauch. Wenn Sie sie aktivieren, ändert sich Ihr Chat-Tarif nicht. Siehe [Abrechnung](https://documentation.deepmask.io/de/api/billing.md).
* **Bezahlung pro Token.** Sie zahlen für die Tokens, die jede Anfrage verbraucht. Es gelten die auf der Registerkarte **Modelle** angezeigten Preise pro 1 Mio. Tokens. Diese Preise enthalten die Gebühr von 3 % bereits, aber keine USt. Siehe [So funktionieren die Preise](https://documentation.deepmask.io/de/api/models.md#so-funktionieren-die-preise).
* **Monatliche Rechnung.** Ihre monatliche Rechnung enthält die Modellkosten plus 3 % Gebühr, zzgl. USt., falls zutreffend. Siehe [Was Sie bezahlen](https://documentation.deepmask.io/de/api/billing.md#was-sie-bezahlen).
* **Fehlgeschlagene Anfragen.** Anfragen, die DeepMask oder der Modellanbieter ablehnt, werden nicht abgerechnet. Eine Anfrage mit unklarem Ergebnis, etwa nach einem Timeout beim Anbieter, wird nur abgerechnet, wenn später noch Nutzung dafür eintrifft. Siehe [Werden fehlgeschlagene Anfragen abgerechnet?](https://documentation.deepmask.io/de/api/errors.md#werden-fehlgeschlagene-anfragen-abgerechnet).
* **Ausgabenlimits.** Das **Gateway-Ausgabenlimit** ist das organisationsweite monatliche Limit für alle Schlüssel zusammen. Zusätzlich kann jeder Schlüssel ein eigenes, optionales Limit haben. Siehe [Ausgabenlimits](https://documentation.deepmask.io/de/api/spending-caps.md).

## API-Dokumentation erkunden

> [card] [Schnellstart](https://documentation.deepmask.io/de/api/quickstart.md)
>
> Aktivieren Sie die Abrechnung, erstellen Sie einen Schlüssel und senden Sie Ihre erste Anfrage.

> [card] [API-Schlüssel](https://documentation.deepmask.io/de/api/keys.md)
>
> Erstellen, prüfen und widerrufen Sie Schlüssel und legen Sie ihre Modelle fest.

> [card] [Ausgabenlimits](https://documentation.deepmask.io/de/api/spending-caps.md)
>
> Begrenzen Sie die monatlichen Ausgaben Ihrer Organisation und jedes einzelnen Schlüssels.

> [card] [Nutzung und Protokolle](https://documentation.deepmask.io/de/api/usage-and-logs.md)
>
> Verfolgen Sie die monatlichen Kosten, prüfen Sie Anfragen und exportieren Sie eine CSV-Datei.

> [card] [Abrechnung](https://documentation.deepmask.io/de/api/billing.md)
>
> Verwalten Sie die API-Abrechnung, Ihre Rechnungen und die Kündigung.

> [card] [Modelle](https://documentation.deepmask.io/de/api/models.md)
>
> Sehen Sie sich API-Modelle und Modell-IDs an und erfahren Sie, wie die Preise funktionieren.

> [card] [Chat Completions](https://documentation.deepmask.io/de/api/chat-completions.md)
>
> Anfrageformat, Bildeingabe, Streaming und Tool-Aufrufe.

> [card] [Limits und faire Nutzung](https://documentation.deepmask.io/de/api/limits.md)
>
> Raten-, Token- und Budgetlimits sowie die Funktionsweise der fairen Nutzung.

> [card] [Fehler und Wiederholungen](https://documentation.deepmask.io/de/api/errors.md)
>
> Fehlercodes, Wiederholungen und ob fehlgeschlagene Anfragen abgerechnet werden.


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