Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.
Diese Anleitung führt Sie Schritt für Schritt zu Ihrer ersten erfolgreichen Anfrage, auch wenn Sie noch keinen API-Zugriff haben. Sie aktivieren die API-Abrechnung für Ihre Organisation, erstellen einen Schlüssel und rufen ein Modell mit cURL, Python oder Node.js auf. Die DeepMask API ist OpenAI-kompatibel. Sie können daher die offiziellen OpenAI-SDKs verwenden, indem Sie die Basis-URL und Ihren DeepMask-API-Schlüssel festlegen. Die API unterstützt Chat Completions (POST /v1/chat/completions) und das Auflisten von Modellen (GET /v1/models). Andere OpenAI-Endpunkte werden nicht unterstützt. Die Responses API (/v1/responses) gibt zum Beispiel 404 zurück.
Neu bei der DeepMask API? In der API-Übersicht erfahren Sie, was die API bietet und wie sie mit Ihrem Chat-Tarif zusammenhängt.
Voraussetzungen
Sie benötigen:
Administratorrechte in Ihrer Organisation. Nur Administratoren der Organisation sehen API in den Benutzereinstellungen. Wenn Sie Mitglied sind, bitten Sie einen Administrator, den Zugriff einzurichten. Informationen zu Rollen finden Sie unter Team-Management.
Einen aktiven kostenpflichtigen Tarif. Ihre Organisation benötigt einen aktiven Pro-, Power- oder Enterprise-Tarif. Der kostenlose Tarif, Testphasen und Tarife mit überfälliger Zahlung beinhalten keinen API-Zugriff.
Eine Zahlungsmethode für die API-Abrechnung. Die API wird getrennt von Ihrem Chat-Tarif abgerechnet. Im Checkout geben Sie daher eine Zahlungsmethode und eine Rechnungsadresse an.
Eine Möglichkeit, Anfragen zu senden. Verwenden Sie curl in einem macOS- oder Linux-Terminal oder das OpenAI-SDK für Python oder Node.js. Unter Windows führen Sie die cURL-Befehle in WSL oder Git Bash aus.
Wenn der Tarif Ihrer Organisation keinen API-Zugriff umfasst, zeigt die API-Seite den Hinweis „Für den API-Zugriff ist ein aktiver kostenpflichtiger Chat-Tarif erforderlich.“ Prüfen Sie Ihren Tarif über den Link Chat-Abrechnung in diesem Hinweis.
Zugriff einrichten und eine Testanfrage senden
1
API-Einstellungen öffnen
Klicken Sie unten in der Chat-Seitenleiste auf Ihren Namen und wählen Sie Benutzereinstellungen. Klicken Sie in der Seitenleiste der Einstellungen auf API.Die Seite zeigt die Basis-URL für alle Anfragen, https://api.deepmask.io/v1, mit einer Schaltfläche zum Kopieren. Darunter befinden sich die Registerkarten Schlüssel, Modelle, Nutzung und Abrechnung.
2
API-Abrechnung aktivieren
Solange die API-Abrechnung nicht aktiv ist, ist Schlüssel erstellen nicht verfügbar, und die Seite zeigt den Hinweis „Aktivieren Sie die API-Abrechnung, um Ihre Schlüssel zu nutzen.“Klicken Sie in diesem Hinweis auf API-Abrechnung aktivieren. Alternativ öffnen Sie die Registerkarte Abrechnung, auf der die Karte API-Abrechnung den Status Nicht aktiviert zeigt, und klicken dort auf API-Abrechnung aktivieren.DeepMask leitet Sie zu Stripe Checkout weiter. Fügen Sie eine Zahlungsmethode hinzu, prüfen Sie Ihre Rechnungsadresse und schließen Sie den Checkout ab. Sind für Ihre Organisation bereits ein Name und eine Rechnungsadresse hinterlegt, trägt der Checkout diese Angaben automatisch ein. Sie können außerdem eine Umsatzsteuer-Identifikationsnummer (USt-IdNr.) angeben. Diese Angabe ist optional. Die API-Abrechnung ist ein Abonnement nach Verbrauch: Ihre monatliche Rechnung enthält die Modellkosten plus 3 % Gebühr, zzgl. USt., falls zutreffend. Details finden Sie unter Abrechnung.
Solange die API-Abrechnung nicht aktiviert ist, fordert Sie die API-Seite auf, sie zu aktivieren, bevor Sie Schlüssel erstellen können.
3
Prüfen, ob die Abrechnung aktiv ist
Nach dem Checkout kehren Sie zur API-Seite zurück, die sich automatisch aktualisiert. Öffnen Sie die Registerkarte Abrechnung und prüfen Sie, ob die Karte API-Abrechnung den Status Aktiv zeigt.Die Aktivierung kann einen Moment dauern. Hat sich der Status noch nicht geändert, warten Sie kurz und klicken Sie oben auf der Seite auf Aktualisieren.Wenn Sie den Checkout verlassen, ohne ihn abzuschließen, bleibt die API-Abrechnung im Status Nicht aktiviert. Klicken Sie auf API-Abrechnung aktivieren, um es erneut zu versuchen.
4
Ausgabenlimit prüfen (optional)
Auf der Registerkarte Abrechnung finden Sie das Gateway-Ausgabenlimit. Das ist das organisationsweite Limit, das für alle Ihre Schlüssel gemeinsam gilt. Es beträgt anfangs 100 € Modellkosten pro Monat, vor der Gebühr von 3 % und vor Steuern. Es wird um 00:00 UTC am 1. eines Monats zurückgesetzt.Um das Limit zu ändern, geben Sie einen Betrag bis zum Höchstwert ein, der unter dem Feld angezeigt wird, und klicken Sie auf Limit speichern. Sie können außerdem für jeden Schlüssel ein eigenes Limit festlegen. Mehr dazu unter Ausgabenlimits.
5
Schlüssel erstellen
Öffnen Sie die Registerkarte Schlüssel und klicken Sie auf Schlüssel erstellen. Gehen Sie im Dialog API-Schlüssel erstellen so vor:
Geben Sie unter Schlüsselname einen Namen ein, der die App oder Umgebung beschreibt, zum Beispiel „Produktionsdienst“.
Geben Sie optional unter Ausgabenlimit des Schlüssels (optional) einen monatlichen Betrag ein. Er darf das Gateway-Ausgabenlimit nicht übersteigen. Lassen Sie das Feld leer, wenn nur das Gateway-Ausgabenlimit gelten soll.
Behalten Sie unter Modellzugriff die Option Modelle auswählen bei und wählen Sie die Modelle aus, die dieser Schlüssel verwenden darf. Die Modelle sind nach Anbieter gruppiert, und jede Gruppe ist zunächst eingeklappt. Für die Beispiele auf dieser Seite suchen Sie nach gpt-4o oder klappen OpenAI auf und wählen GPT-4o aus. Alternativ wählen Sie Alle aktuellen Modelle, um alle heute verfügbaren Modelle freizugeben. Später hinzugefügte Modelle sind nicht enthalten.
Klicken Sie auf Schlüssel erstellen.
Die Modelle eines Schlüssels können Sie nach dem Erstellen nicht mehr ändern. Um andere Modelle freizugeben, erstellen Sie einen neuen Schlüssel. Mehr dazu unter API-Schlüssel.
6
Schlüssel speichern
Der Dialog API-Schlüssel speichern zeigt Ihren neuen Schlüssel. Klicken Sie auf Schlüssel kopieren und speichern Sie ihn an einem sicheren Ort, etwa in Ihrem Secret-Manager oder in einer Umgebungsvariablen.
DeepMask zeigt den vollständigen Schlüssel nur ein einziges Mal. Wenn Sie den Dialog schließen, die Seite neu laden oder die Organisation wechseln, bevor Sie den Schlüssel kopiert haben, können Sie ihn nicht mehr abrufen. Haben Sie ihn verloren, widerrufen Sie den Schlüssel und erstellen Sie einen neuen.
7
Schlüssel testen
Klappen Sie den Bereich Schlüssel testen auf, bevor Sie den Dialog schließen. Setzen Sie die Umgebungsvariable DEEPMASK_API_KEY auf Ihren Schlüssel:
export DEEPMASK_API_KEY="sk-..."
Damit der Schlüssel nicht in Ihrem Shell-Verlauf landet, führen Sie stattdessen read -rs DEEPMASK_API_KEY && export DEEPMASK_API_KEY aus. Fügen Sie dann den Schlüssel ein und drücken Sie die Eingabetaste.Klicken Sie auf Befehl kopieren, fügen Sie den Befehl in dasselbe Terminal ein und führen Sie ihn aus. Der Befehl sendet „Hello“ an eines der Modelle des Schlüssels. Gibt der Befehl eine JSON-Antwort mit einer Nachricht des Modells zurück, funktioniert Ihr Schlüssel. Testanfragen werden wie jede andere Anfrage abgerechnet.Wenn Sie fertig sind, klicken Sie auf Ich habe ihn gespeichert, um den Dialog zu schließen.
Kopieren Sie Ihren Schlüssel, bevor Sie den Dialog schließen, und testen Sie ihn dann mit dem vorbereiteten Befehl.
Verwenden Sie Ihren Schlüssel nur auf Ihrem Server. Lesen Sie ihn aus einer Umgebungsvariablen oder einem Secret-Manager und legen Sie ihn nie in Browsercode, mobilen Apps oder der Versionsverwaltung ab.
Ihre erste Anfrage senden
Senden Sie eine Chat-Completion-Anfrage an POST /v1/chat/completions. Jedes Beispiel liest Ihren Schlüssel aus DEEPMASK_API_KEY und verwendet gpt-4o. Für ein anderes Modell kopieren Sie dessen API-Modell-ID auf der Registerkarte Modelle und stellen sicher, dass Ihr Schlüssel das Modell verwenden darf.Installieren Sie für die SDK-Beispiele das offizielle Paket openai:
Python: Führen Sie pip install openai aus. Speichern Sie das Beispiel als quickstart.py und führen Sie python quickstart.py aus.
Node.js: Führen Sie npm install openai aus. Speichern Sie das Beispiel im selben Ordner als quickstart.mjs und führen Sie node quickstart.mjs aus. Dank der Endung .mjs kann die Datei import und Top-Level-await verwenden.
Führen Sie die Beispiele in demselben Terminal aus, in dem Sie DEEPMASK_API_KEY gesetzt haben. In Windows PowerShell setzen Sie die Variable stattdessen mit $env:DEEPMASK_API_KEY = "sk-...".
curl https://api.deepmask.io/v1/chat/completions \ -H "Authorization: Bearer $DEEPMASK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o", "messages": [ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Explain what an API key is in one sentence."} ], "max_tokens": 200 }'
import osfrom openai import OpenAIclient = OpenAI( base_url="https://api.deepmask.io/v1", api_key=os.environ["DEEPMASK_API_KEY"],)response = client.chat.completions.create( model="gpt-4o", messages=[ {"role": "system", "content": "You are a concise assistant."}, {"role": "user", "content": "Explain what an API key is in one sentence."}, ], max_tokens=200,)print(response.choices[0].message.content)
import OpenAI from "openai";const client = new OpenAI({ baseURL: "https://api.deepmask.io/v1", apiKey: process.env.DEEPMASK_API_KEY,});const response = await client.chat.completions.create({ model: "gpt-4o", messages: [ { role: "system", content: "You are a concise assistant." }, { role: "user", content: "Explain what an API key is in one sentence." }, ], max_tokens: 200,});console.log(response.choices[0].message.content);
Die API akzeptiert eine feste Auswahl an Anfragefeldern. max_tokens aus den Beispielen oben gehört dazu. Sampling-Optionen wie temperature, top_p, stop und seed werden innerhalb ihrer Wertebereiche akzeptiert. Manche Modelle ignorieren einige dieser Optionen ohne Fehlermeldung. Manche Modelle lehnen bestimmte Werte ab, zum Beispiel eine temperature über 1. Andere Parameter wie response_format und logprobs werden mit dem Fehler 400 und dem Code API_REQUEST_UNBOUNDED abgelehnt. Das gilt auch für einen Wert von n ungleich 1. Prüfen Sie Sampling-Optionen und Nicht unterstützte Parameter, bevor Sie Optionen hinzufügen.
Die Antwort auswerten
Eine erfolgreiche Anfrage gibt HTTP 200 mit einem Standard-Chat-Completion-Objekt zurück. Das folgende Beispiel ist gekürzt. Ihre Werte sehen anders aus:
{ "id": "chatcmpl-...", "object": "chat.completion", "model": "gpt-4o", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "An API key is a secret token that identifies your app when it calls an API." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 27, "completion_tokens": 18, "total_tokens": 45 }}
choices[0].message.content enthält die Antwort des Modells.
usage zeigt die Eingabe- und Ausgabe-Tokens der Anfrage. Anfragen werden nach Tokens abgerechnet. Wie die Preise funktionieren, erfahren Sie unter Modelle.
Ihre Anfrage erscheint außerdem im Anfrageprotokoll auf der Registerkarte Nutzung. Wenn Sie sie noch nicht sehen, klicken Sie oben auf der Seite auf Aktualisieren. Mehr dazu unter Nutzung und Protokolle.Um die Antwort schon in Teilen zu erhalten, während das Modell sie schreibt, setzen Sie stream auf true. Streaming, Tools und alle unterstützten Felder sind unter Chat Completions beschrieben.
Wenn Ihre erste Anfrage fehlschlägt
Bei jedem Fehler gibt die API einen JSON-Body zurück, dessen Feld error.code das Problem benennt, zum Beispiel API_MODEL_NOT_ALLOWED. Der Text in error.message ist immer derselbe. Prüfen Sie daher den HTTP-Status und error.code. Den vollständigen Body finden Sie unter Format der Fehlerantwort.
Status
Code
Was Sie prüfen sollten
401
API_CREDENTIAL_INVALID
Der Schlüssel fehlt, ist falsch geschrieben oder wurde widerrufen. Senden Sie genau einen Header Authorization: Bearer <key>.
403
API_SUBSCRIPTION_INACTIVE
Die API-Abrechnung ist nicht aktiv, oder Ihre Organisation hat keinen aktiven kostenpflichtigen Tarif. Prüfen Sie den Status der API-Abrechnung auf der Registerkarte Abrechnung und eventuelle Hinweise oben auf der API-Seite.
403
API_MODEL_NOT_ALLOWED
Der Schlüssel hat keinen Zugriff auf dieses Modell. Geben Sie die API-Modell-ID genau so an, wie sie angezeigt wird, und prüfen Sie, ob der Schlüssel das Modell enthält.
400
API_REQUEST_INVALID
Der Anfragetext ist kein gültiges JSON, der Header Content-Type: application/json fehlt oder model fehlt. Prüfen Sie Anführungszeichen und Header.
400
API_REQUEST_UNBOUNDED
Die Anfrage enthält ein nicht unterstütztes Feld oder einen unzulässigen Wert, zum Beispiel response_format oder eine temperature über 2.
404
API_ENDPOINT_NOT_FOUND
Der Pfad wird nicht unterstützt. Prüfen Sie, ob Ihre Basis-URL genau https://api.deepmask.io/v1 lautet, und rufen Sie /v1/chat/completions ohne abschließenden Schrägstrich auf. Ein Pfad außerhalb von /v1/ gibt 404 mit leerem Body zurück.
Sie haben ein Limit erreicht. Die meisten Limits gelten für alle Schlüssel Ihrer Organisation gemeinsam. Jeder Schlüssel hat außerdem einige eigene Limits. Siehe API-Limits auf der Registerkarte Nutzung und Limits im Überblick. API_MODEL_CAPACITY bedeutet, dass das Modell sein Kapazitätslimit erreicht hat, das sich alle Organisationen teilen. Warten Sie kurz und versuchen Sie es erneut, oder verwenden Sie ein anderes Modell.
503
API_ADMISSION_UNAVAILABLE
DeepMask kann gerade keine Anfragen für Ihre Organisation annehmen. Warten Sie eine Minute und versuchen Sie es erneut. Tritt der Fehler weiterhin auf, prüfen Sie den Hinweis oben auf der API-Seite. Steht dort, dass Anfragen pausiert sind, wiederholen Sie Anfragen nicht in einer Schleife. Siehe Wann Anfragen pausiert werden.
503, 504
API_INFERENCE_UNAVAILABLE
DeepMask konnte keine Antwort vom Modell erhalten. Ihnen wird nichts berechnet, es sei denn, für die Anfrage wird später doch noch Nutzung erfasst. Wiederholen Sie die Anfrage mit Backoff, senden Sie sie aber nicht in einer Schleife erneut. Mehr als 20 solcher Fehler innerhalb von 24 Stunden pausieren die Anfragen Ihrer Organisation. Siehe Unklare Ergebnisse.
Welche Modelle Ihr Schlüssel verwenden darf, erfahren Sie mit GET /v1/models. Der Aufruf gibt nur die Modelle zurück, die für diesen Schlüssel freigegeben sind:
Erstellen Sie Schlüssel pro App oder Umgebung, prüfen Sie ihren Status und widerrufen Sie Schlüssel, die Sie nicht mehr benötigen.
Ausgabenlimits festlegen
Steuern Sie die monatlichen Modellkosten mit dem organisationsweiten Limit und optionalen Limits pro Schlüssel.
Referenz zu Chat Completions
Lernen Sie die unterstützten Anfragefelder, Streaming, Tool-Aufrufe und das Antwortformat kennen.
Modelle und Preise
Durchsuchen Sie die API-Modelle, finden Sie ihre Modell-IDs und erfahren Sie, wie die Preise pro Token funktionieren.
Limits und faire Nutzung
Prüfen Sie die Raten-, Token- und Budgetlimits, die für Ihre Anfragen gelten.
Fehler und Wiederholungen
Erfahren Sie, was Fehlercodes bedeuten, welche Fehler Sie wiederholen sollten und wie Sie mit abgelehnten Anfragen umgehen.
Nutzung und Protokolle
Verfolgen Sie die monatlichen Kosten, prüfen Sie Ihre API-Limits und sehen Sie sich Ihre Anfragen an.
Abrechnung
Erfahren Sie, wie sich Ihre monatliche API-Rechnung zusammensetzt, rufen Sie Rechnungen ab und beenden Sie bei Bedarf die API-Abrechnung.
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"DeepMask","colors":{"primary":"#139058","light":"#cecece","dark":"#252525"},"logo":{"light":"https://mintcdn.com/deepmaskgmbh/wqYs4HgxrHF-vtoI/images/light-theme-logo-B6Sj8q9n.svg?fit=max\u0026auto=format\u0026n=wqYs4HgxrHF-vtoI\u0026q=85\u0026s=b2e82def8bcaaf56f11738b4e22b9748","dark":"https://mintcdn.com/deepmaskgmbh/wqYs4HgxrHF-vtoI/images/dark-theme-logo--PYJYRlW.svg?fit=max\u0026auto=format\u0026n=wqYs4HgxrHF-vtoI\u0026q=85\u0026s=9aa25f507641b624ce8abc85888b8c16"},"favicon":{"light":"https://mintcdn.com/deepmaskgmbh/IMUyo8_jXysaqNdQ/images/Untitleddesign(30).png?fit=max\u0026auto=format\u0026n=IMUyo8_jXysaqNdQ\u0026q=85\u0026s=02005d43e5d29ab31e5fb0bc8f0175d7","dark":"https://mintcdn.com/deepmaskgmbh/IMUyo8_jXysaqNdQ/images/DeepMaskIcononly1025x1025_white.png?fit=max\u0026auto=format\u0026n=IMUyo8_jXysaqNdQ\u0026q=85\u0026s=ab8caac67616c37907783c84cd4cb817"},"navbar":{"primary":{"type":"button","label":"Try DeepMask","href":"https://chat.deepmask.io/"}},"fonts":{"family":"Open Sans"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"de","href":"de/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"deepmaskgmbh","hasAudioNarration":false,"actualSubdomain":"deepmaskgmbh","customDomains":["documentation.deepmask.io"],"gitSource":{"type":"github","owner":"musmani22","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb564be59e7a15fc0aa49f","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"Documentation","count":67},{"language":"de","tag":"Dokumentation","count":67},{"language":"en","tag":"Connectors","count":44},{"language":"de","tag":"Konnektoren","count":44},{"language":"en","tag":"Models","count":24},{"language":"de","tag":"Modelle","count":24},{"language":"en","tag":"Outlook","count":16},{"language":"de","tag":"Outlook","count":16},{"language":"en","tag":"API","count":10},{"language":"en","tag":"SharePoint (Enterprise)","count":10},{"language":"de","tag":"API","count":10},{"language":"de","tag":"SharePoint (Enterprise)","count":10},{"language":"en","tag":"Salesforce (Enterprise)","count":9},{"language":"en","tag":"Google \u0026 Others","count":9},{"language":"de","tag":"Salesforce (Enterprise)","count":9},{"language":"de","tag":"Google \u0026 andere","count":9},{"language":"en","tag":"OneDrive (Personal)","count":8},{"language":"de","tag":"OneDrive (Persönlich)","count":8},{"language":"en","tag":"Core Features","count":7},{"language":"de","tag":"Kernfunktionen","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"de/api/quickstart","slug":"/de/api/quickstart","pageMetadata":{"title":"API-Schnellstart","sidebarTitle":"Schnellstart","description":"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.","keywords":["API","Schnellstart","API-Schlüssel","Chat Completions","OpenAI-kompatibel","OpenAI-SDK","cURL","Python","Node.js","API-Abrechnung"],"href":"/de/api/quickstart"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,CodeGroup,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Diese Anleitung führt Sie Schritt für Schritt zu Ihrer ersten erfolgreichen Anfrage, auch wenn Sie noch keinen API-Zugriff haben. Sie aktivieren die API-Abrechnung für Ihre Organisation, erstellen einen Schlüssel und rufen ein Modell mit cURL, Python oder Node.js auf. Die DeepMask API ist OpenAI-kompatibel. Sie können daher die offiziellen OpenAI-SDKs verwenden, indem Sie die Basis-URL und Ihren DeepMask-API-Schlüssel festlegen. Die API unterstützt Chat Completions (`,_jsx(_components.code,{children:`POST /v1/chat/completions`}),`) und das Auflisten von Modellen (`,_jsx(_components.code,{children:`GET /v1/models`}),`). Andere OpenAI-Endpunkte werden nicht unterstützt. Die Responses API (`,_jsx(_components.code,{children:`/v1/responses`}),`) gibt zum Beispiel `,_jsx(_components.code,{children:`404`}),` zurück.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Neu bei der DeepMask API? In der `,_jsx(_components.a,{href:`/de/api/overview`,children:`API-Übersicht`}),` erfahren Sie, was die API bietet und wie sie mit Ihrem Chat-Tarif zusammenhängt.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`voraussetzungen`,children:`Voraussetzungen`}),`\n`,_jsx(_components.p,{children:`Sie benötigen:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Administratorrechte in Ihrer Organisation.`}),` Nur Administratoren der Organisation sehen `,_jsx(_components.strong,{children:`API`}),` in den `,_jsx(_components.strong,{children:`Benutzereinstellungen`}),`. Wenn Sie Mitglied sind, bitten Sie einen Administrator, den Zugriff einzurichten. Informationen zu Rollen finden Sie unter `,_jsx(_components.a,{href:`/de/enterprise/team-management`,children:`Team-Management`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Einen aktiven kostenpflichtigen Tarif.`}),` Ihre Organisation benötigt einen aktiven Pro-, Power- oder Enterprise-Tarif. Der kostenlose Tarif, Testphasen und Tarife mit überfälliger Zahlung beinhalten keinen API-Zugriff.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Eine Zahlungsmethode für die API-Abrechnung.`}),` Die API wird getrennt von Ihrem Chat-Tarif abgerechnet. Im Checkout geben Sie daher eine Zahlungsmethode und eine Rechnungsadresse an.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Eine Möglichkeit, Anfragen zu senden.`}),` Verwenden Sie `,_jsx(_components.code,{children:`curl`}),` in einem macOS- oder Linux-Terminal oder das OpenAI-SDK für Python oder Node.js. Unter Windows führen Sie die cURL-Befehle in WSL oder Git Bash aus.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Wenn der Tarif Ihrer Organisation keinen API-Zugriff umfasst, zeigt die API-Seite den Hinweis „Für den API-Zugriff ist ein aktiver kostenpflichtiger Chat-Tarif erforderlich.“ Prüfen Sie Ihren Tarif über den Link `,_jsx(_components.strong,{children:`Chat-Abrechnung`}),` in diesem Hinweis.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`zugriff-einrichten-und-eine-testanfrage-senden`,children:`Zugriff einrichten und eine Testanfrage senden`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`API-Einstellungen öffnen`,children:[_jsxs(_components.p,{children:[`Klicken Sie unten in der Chat-Seitenleiste auf Ihren Namen und wählen Sie `,_jsx(_components.strong,{children:`Benutzereinstellungen`}),`. Klicken Sie in der Seitenleiste der Einstellungen auf `,_jsx(_components.strong,{children:`API`}),`.`]}),_jsxs(_components.p,{children:[`Die Seite zeigt die `,_jsx(_components.strong,{children:`Basis-URL`}),` für alle Anfragen, `,_jsx(_components.code,{children:`https://api.deepmask.io/v1`}),`, mit einer Schaltfläche zum Kopieren. Darunter befinden sich die Registerkarten `,_jsx(_components.strong,{children:`Schlüssel`}),`, `,_jsx(_components.strong,{children:`Modelle`}),`, `,_jsx(_components.strong,{children:`Nutzung`}),` und `,_jsx(_components.strong,{children:`Abrechnung`}),`.`]})]}),_jsxs(Step,{title:`API-Abrechnung aktivieren`,children:[_jsxs(_components.p,{children:[`Solange die API-Abrechnung nicht aktiv ist, ist `,_jsx(_components.strong,{children:`Schlüssel erstellen`}),` nicht verfügbar, und die Seite zeigt den Hinweis „Aktivieren Sie die API-Abrechnung, um Ihre Schlüssel zu nutzen.“`]}),_jsxs(_components.p,{children:[`Klicken Sie in diesem Hinweis auf `,_jsx(_components.strong,{children:`API-Abrechnung aktivieren`}),`. Alternativ öffnen Sie die Registerkarte `,_jsx(_components.strong,{children:`Abrechnung`}),`, auf der die Karte `,_jsx(_components.strong,{children:`API-Abrechnung`}),` den Status `,_jsx(_components.strong,{children:`Nicht aktiviert`}),` zeigt, und klicken dort auf `,_jsx(_components.strong,{children:`API-Abrechnung aktivieren`}),`.`]}),_jsxs(_components.p,{children:[`DeepMask leitet Sie zu Stripe Checkout weiter. Fügen Sie eine Zahlungsmethode hinzu, prüfen Sie Ihre Rechnungsadresse und schließen Sie den Checkout ab. Sind für Ihre Organisation bereits ein Name und eine Rechnungsadresse hinterlegt, trägt der Checkout diese Angaben automatisch ein. Sie können außerdem eine Umsatzsteuer-Identifikationsnummer (USt-IdNr.) angeben. Diese Angabe ist optional. Die API-Abrechnung ist ein Abonnement nach Verbrauch: Ihre monatliche Rechnung enthält die Modellkosten plus 3 % Gebühr, zzgl. USt., falls zutreffend. Details finden Sie unter `,_jsx(_components.a,{href:`/de/api/billing`,children:`Abrechnung`}),`.`]}),_jsx(Frame,{caption:`Solange die API-Abrechnung nicht aktiviert ist, fordert Sie die API-Seite auf, sie zu aktivieren, bevor Sie Schlüssel erstellen können.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=14810333d63c363dd8bfc1c5975173fb`,alt:`API-Einstellungsseite mit dem Hinweis „Aktivieren Sie die API-Abrechnung, um Ihre Schlüssel zu nutzen.“ und der Schaltfläche „API-Abrechnung aktivieren“, darunter die Basis-URL und eine leere Registerkarte „Schlüssel“.`,\"data-og-width\":`1410`,width:`1410`,\"data-og-height\":`994`,height:`994`,\"data-path\":`images/api/de/enable-billing.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=6e5cb206a4f4b932dca07f37f45a5699 280w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=060acc7276e4e1f193339bcadedd0993 560w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=a5ea1d87ea188d790fa84041df0ec60e 840w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=6b38455b0adafaec4bab0caa174a1803 1100w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=209839cb7c39e6b4eb618eb849543708 1650w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/enable-billing.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=796f10c0d6083d17a0799f26ddb73aec 2500w`})})]}),_jsxs(Step,{title:`Prüfen, ob die Abrechnung aktiv ist`,children:[_jsxs(_components.p,{children:[`Nach dem Checkout kehren Sie zur API-Seite zurück, die sich automatisch aktualisiert. Öffnen Sie die Registerkarte `,_jsx(_components.strong,{children:`Abrechnung`}),` und prüfen Sie, ob die Karte `,_jsx(_components.strong,{children:`API-Abrechnung`}),` den Status `,_jsx(_components.strong,{children:`Aktiv`}),` zeigt.`]}),_jsxs(_components.p,{children:[`Die Aktivierung kann einen Moment dauern. Hat sich der Status noch nicht geändert, warten Sie kurz und klicken Sie oben auf der Seite auf `,_jsx(_components.strong,{children:`Aktualisieren`}),`.`]}),_jsxs(_components.p,{children:[`Wenn Sie den Checkout verlassen, ohne ihn abzuschließen, bleibt die API-Abrechnung im Status `,_jsx(_components.strong,{children:`Nicht aktiviert`}),`. Klicken Sie auf `,_jsx(_components.strong,{children:`API-Abrechnung aktivieren`}),`, um es erneut zu versuchen.`]})]}),_jsxs(Step,{title:`Ausgabenlimit prüfen (optional)`,children:[_jsxs(_components.p,{children:[`Auf der Registerkarte `,_jsx(_components.strong,{children:`Abrechnung`}),` finden Sie das `,_jsx(_components.strong,{children:`Gateway-Ausgabenlimit`}),`. Das ist das organisationsweite Limit, das für alle Ihre Schlüssel gemeinsam gilt. Es beträgt anfangs 100 € Modellkosten pro Monat, vor der Gebühr von 3 % und vor Steuern. Es wird um 00:00 UTC am 1. eines Monats zurückgesetzt.`]}),_jsxs(_components.p,{children:[`Um das Limit zu ändern, geben Sie einen Betrag bis zum Höchstwert ein, der unter dem Feld angezeigt wird, und klicken Sie auf `,_jsx(_components.strong,{children:`Limit speichern`}),`. Sie können außerdem für jeden Schlüssel ein eigenes Limit festlegen. Mehr dazu unter `,_jsx(_components.a,{href:`/de/api/spending-caps`,children:`Ausgabenlimits`}),`.`]})]}),_jsxs(Step,{title:`Schlüssel erstellen`,children:[_jsxs(_components.p,{children:[`Öffnen Sie die Registerkarte `,_jsx(_components.strong,{children:`Schlüssel`}),` und klicken Sie auf `,_jsx(_components.strong,{children:`Schlüssel erstellen`}),`. Gehen Sie im Dialog `,_jsx(_components.strong,{children:`API-Schlüssel erstellen`}),` so vor:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Geben Sie unter `,_jsx(_components.strong,{children:`Schlüsselname`}),` einen Namen ein, der die App oder Umgebung beschreibt, zum Beispiel „Produktionsdienst“.`]}),`\n`,_jsxs(_components.li,{children:[`Geben Sie optional unter `,_jsx(_components.strong,{children:`Ausgabenlimit des Schlüssels (optional)`}),` einen monatlichen Betrag ein. Er darf das `,_jsx(_components.strong,{children:`Gateway-Ausgabenlimit`}),` nicht übersteigen. Lassen Sie das Feld leer, wenn nur das `,_jsx(_components.strong,{children:`Gateway-Ausgabenlimit`}),` gelten soll.`]}),`\n`,_jsxs(_components.li,{children:[`Behalten Sie unter `,_jsx(_components.strong,{children:`Modellzugriff`}),` die Option `,_jsx(_components.strong,{children:`Modelle auswählen`}),` bei und wählen Sie die Modelle aus, die dieser Schlüssel verwenden darf. Die Modelle sind nach Anbieter gruppiert, und jede Gruppe ist zunächst eingeklappt. Für die Beispiele auf dieser Seite suchen Sie nach `,_jsx(_components.code,{children:`gpt-4o`}),` oder klappen `,_jsx(_components.strong,{children:`OpenAI`}),` auf und wählen GPT-4o aus. Alternativ wählen Sie `,_jsx(_components.strong,{children:`Alle aktuellen Modelle`}),`, um alle heute verfügbaren Modelle freizugeben. Später hinzugefügte Modelle sind nicht enthalten.`]}),`\n`,_jsxs(_components.li,{children:[`Klicken Sie auf `,_jsx(_components.strong,{children:`Schlüssel erstellen`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`Die Modelle eines Schlüssels können Sie nach dem Erstellen nicht mehr ändern. Um andere Modelle freizugeben, erstellen Sie einen neuen Schlüssel. Mehr dazu unter `,_jsx(_components.a,{href:`/de/api/keys`,children:`API-Schlüssel`}),`.`]})]}),_jsxs(Step,{title:`Schlüssel speichern`,children:[_jsxs(_components.p,{children:[`Der Dialog `,_jsx(_components.strong,{children:`API-Schlüssel speichern`}),` zeigt Ihren neuen Schlüssel. Klicken Sie auf `,_jsx(_components.strong,{children:`Schlüssel kopieren`}),` und speichern Sie ihn an einem sicheren Ort, etwa in Ihrem Secret-Manager oder in einer Umgebungsvariablen.`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`DeepMask zeigt den vollständigen Schlüssel nur ein einziges Mal. Wenn Sie den Dialog schließen, die Seite neu laden oder die Organisation wechseln, bevor Sie den Schlüssel kopiert haben, können Sie ihn nicht mehr abrufen. Haben Sie ihn verloren, widerrufen Sie den Schlüssel und erstellen Sie einen neuen.`})})]}),_jsxs(Step,{title:`Schlüssel testen`,children:[_jsxs(_components.p,{children:[`Klappen Sie den Bereich `,_jsx(_components.strong,{children:`Schlüssel testen`}),` auf, bevor Sie den Dialog schließen. Setzen Sie die Umgebungsvariable `,_jsx(_components.code,{children:`DEEPMASK_API_KEY`}),` auf Ihren Schlüssel:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` DEEPMASK_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sk-...\"`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Damit der Schlüssel nicht in Ihrem Shell-Verlauf landet, führen Sie stattdessen `,_jsx(_components.code,{children:`read -rs DEEPMASK_API_KEY \u0026\u0026 export DEEPMASK_API_KEY`}),` aus. Fügen Sie dann den Schlüssel ein und drücken Sie die Eingabetaste.`]}),_jsxs(_components.p,{children:[`Klicken Sie auf `,_jsx(_components.strong,{children:`Befehl kopieren`}),`, fügen Sie den Befehl in dasselbe Terminal ein und führen Sie ihn aus. Der Befehl sendet „Hello“ an eines der Modelle des Schlüssels. Gibt der Befehl eine JSON-Antwort mit einer Nachricht des Modells zurück, funktioniert Ihr Schlüssel. Testanfragen werden wie jede andere Anfrage abgerechnet.`]}),_jsxs(_components.p,{children:[`Wenn Sie fertig sind, klicken Sie auf `,_jsx(_components.strong,{children:`Ich habe ihn gespeichert`}),`, um den Dialog zu schließen.`]}),_jsx(Frame,{caption:`Kopieren Sie Ihren Schlüssel, bevor Sie den Dialog schließen, und testen Sie ihn dann mit dem vorbereiteten Befehl.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=9ea1aacd2bacc3d6e475c0d3767b09ce`,alt:`Dialog „API-Schlüssel speichern“ mit dem Schlüssel in einem schreibgeschützten Feld, der Schaltfläche „Schlüssel kopieren“, der Warnung „Einmalig sichtbar“, dem aufgeklappten Bereich „Schlüssel testen“ mit einem cURL-Befehl und der Schaltfläche „Befehl kopieren“ sowie der Schaltfläche „Ich habe ihn gespeichert“.`,\"data-og-width\":`1410`,width:`1410`,\"data-og-height\":`1171`,height:`1171`,\"data-path\":`images/api/de/save-key.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=b19b02a16095f88fc7c358dbe9ea74f6 280w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=a4d9dadff652a3de50075af425eb9cb5 560w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=ce0b82cc0a43535854dc323cfaca4681 840w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=387c46193bb6cc2b459252a32a7566a5 1100w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=290cb05687d5b610e92cf5bd576411fb 1650w, https://mintcdn.com/deepmaskgmbh/Tc7tJrGOE8MSnXNJ/images/api/de/save-key.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=Tc7tJrGOE8MSnXNJ\u0026q=85\u0026s=02e490bd8f9f547e5646505c99c853d7 2500w`})})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Verwenden Sie Ihren Schlüssel nur auf Ihrem Server. Lesen Sie ihn aus einer Umgebungsvariablen oder einem Secret-Manager und legen Sie ihn nie in Browsercode, mobilen Apps oder der Versionsverwaltung ab.`})}),`\n`,_jsx(Heading,{level:`2`,id:`ihre-erste-anfrage-senden`,children:`Ihre erste Anfrage senden`}),`\n`,_jsxs(_components.p,{children:[`Senden Sie eine Chat-Completion-Anfrage an `,_jsx(_components.code,{children:`POST /v1/chat/completions`}),`. Jedes Beispiel liest Ihren Schlüssel aus `,_jsx(_components.code,{children:`DEEPMASK_API_KEY`}),` und verwendet `,_jsx(_components.code,{children:`gpt-4o`}),`. Für ein anderes Modell kopieren Sie dessen `,_jsx(_components.strong,{children:`API-Modell-ID`}),` auf der Registerkarte `,_jsx(_components.strong,{children:`Modelle`}),` und stellen sicher, dass Ihr Schlüssel das Modell verwenden darf.`]}),`\n`,_jsxs(_components.p,{children:[`Installieren Sie für die SDK-Beispiele das offizielle Paket `,_jsx(_components.code,{children:`openai`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Python:`}),` Führen Sie `,_jsx(_components.code,{children:`pip install openai`}),` aus. Speichern Sie das Beispiel als `,_jsx(_components.code,{children:`quickstart.py`}),` und führen Sie `,_jsx(_components.code,{children:`python quickstart.py`}),` aus.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Node.js:`}),` Führen Sie `,_jsx(_components.code,{children:`npm install openai`}),` aus. Speichern Sie das Beispiel im selben Ordner als `,_jsx(_components.code,{children:`quickstart.mjs`}),` und führen Sie `,_jsx(_components.code,{children:`node quickstart.mjs`}),` aus. Dank der Endung `,_jsx(_components.code,{children:`.mjs`}),` kann die Datei `,_jsx(_components.code,{children:`import`}),` und Top-Level-`,_jsx(_components.code,{children:`await`}),` verwenden.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Führen Sie die Beispiele in demselben Terminal aus, in dem Sie `,_jsx(_components.code,{children:`DEEPMASK_API_KEY`}),` gesetzt haben. In Windows PowerShell setzen Sie die Variable stattdessen mit `,_jsx(_components.code,{children:`$env:DEEPMASK_API_KEY = \"sk-...\"`}),`.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.deepmask.io/v1/chat/completions`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$DEEPMASK_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"gpt-4o\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"messages\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"role\": \"system\", \"content\": \"You are a concise assistant.\"},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"role\": \"user\", \"content\": \"Explain what an API key is in one sentence.\"}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"max_tokens\": 200`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`18`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` openai `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` OpenAI`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` OpenAI(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` base_url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.deepmask.io/v1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DEEPMASK_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.chat.completions.create(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` model`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-4o\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` messages`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"system\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You are a concise assistant.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Explain what an API key is in one sentence.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` max_tokens`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.choices[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].message.content)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`17`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` OpenAI`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"openai\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` OpenAI`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` baseURL:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.deepmask.io/v1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`DEEPMASK_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`chat`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`completions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"gpt-4o\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` messages:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`role:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"system\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`content:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"You are a concise assistant.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`role:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`content:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Explain what an API key is in one sentence.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` max_tokens:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`choices`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`content`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Die API akzeptiert eine feste Auswahl an Anfragefeldern. `,_jsx(_components.code,{children:`max_tokens`}),` aus den Beispielen oben gehört dazu. Sampling-Optionen wie `,_jsx(_components.code,{children:`temperature`}),`, `,_jsx(_components.code,{children:`top_p`}),`, `,_jsx(_components.code,{children:`stop`}),` und `,_jsx(_components.code,{children:`seed`}),` werden innerhalb ihrer Wertebereiche akzeptiert. Manche Modelle ignorieren einige dieser Optionen ohne Fehlermeldung. Manche Modelle lehnen bestimmte Werte ab, zum Beispiel eine `,_jsx(_components.code,{children:`temperature`}),` über 1. Andere Parameter wie `,_jsx(_components.code,{children:`response_format`}),` und `,_jsx(_components.code,{children:`logprobs`}),` werden mit dem Fehler `,_jsx(_components.code,{children:`400`}),` und dem Code `,_jsx(_components.code,{children:`API_REQUEST_UNBOUNDED`}),` abgelehnt. Das gilt auch für einen Wert von `,_jsx(_components.code,{children:`n`}),` ungleich 1. Prüfen Sie `,_jsx(_components.a,{href:`/de/api/chat-completions#sampling-optionen`,children:`Sampling-Optionen`}),` und `,_jsx(_components.a,{href:`/de/api/chat-completions#nicht-unterst%C3%BCtzte-parameter`,children:`Nicht unterstützte Parameter`}),`, bevor Sie Optionen hinzufügen.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`die-antwort-auswerten`,children:`Die Antwort auswerten`}),`\n`,_jsxs(_components.p,{children:[`Eine erfolgreiche Anfrage gibt HTTP `,_jsx(_components.code,{children:`200`}),` mit einem Standard-Chat-Completion-Objekt zurück. Das folgende Beispiel ist gekürzt. Ihre Werte sehen anders aus:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chatcmpl-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"chat.completion\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-4o\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"choices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"index\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"assistant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"An API key is a secret token that identifies your app when it calls an API.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"finish_reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"stop\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`27`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completion_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`18`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`45`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`choices[0].message.content`}),` enthält die Antwort des Modells.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`usage`}),` zeigt die Eingabe- und Ausgabe-Tokens der Anfrage. Anfragen werden nach Tokens abgerechnet. Wie die Preise funktionieren, erfahren Sie unter `,_jsx(_components.a,{href:`/de/api/models`,children:`Modelle`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Ihre Anfrage erscheint außerdem im `,_jsx(_components.strong,{children:`Anfrageprotokoll`}),` auf der Registerkarte `,_jsx(_components.strong,{children:`Nutzung`}),`. Wenn Sie sie noch nicht sehen, klicken Sie oben auf der Seite auf `,_jsx(_components.strong,{children:`Aktualisieren`}),`. Mehr dazu unter `,_jsx(_components.a,{href:`/de/api/usage-and-logs`,children:`Nutzung und Protokolle`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Um die Antwort schon in Teilen zu erhalten, während das Modell sie schreibt, setzen Sie `,_jsx(_components.code,{children:`stream`}),` auf `,_jsx(_components.code,{children:`true`}),`. Streaming, Tools und alle unterstützten Felder sind unter `,_jsx(_components.a,{href:`/de/api/chat-completions`,children:`Chat Completions`}),` beschrieben.`]}),`\n`,_jsx(Heading,{level:`2`,id:`wenn-ihre-erste-anfrage-fehlschlägt`,children:`Wenn Ihre erste Anfrage fehlschlägt`}),`\n`,_jsxs(_components.p,{children:[`Bei jedem Fehler gibt die API einen JSON-Body zurück, dessen Feld `,_jsx(_components.code,{children:`error.code`}),` das Problem benennt, zum Beispiel `,_jsx(_components.code,{children:`API_MODEL_NOT_ALLOWED`}),`. Der Text in `,_jsx(_components.code,{children:`error.message`}),` ist immer derselbe. Prüfen Sie daher den HTTP-Status und `,_jsx(_components.code,{children:`error.code`}),`. Den vollständigen Body finden Sie unter `,_jsx(_components.a,{href:`/de/api/errors#format-der-fehlerantwort`,children:`Format der Fehlerantwort`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Was Sie prüfen sollten`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_CREDENTIAL_INVALID`})}),_jsxs(_components.td,{children:[`Der Schlüssel fehlt, ist falsch geschrieben oder wurde widerrufen. Senden Sie genau einen Header `,_jsx(_components.code,{children:`Authorization: Bearer \u003ckey>`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_SUBSCRIPTION_INACTIVE`})}),_jsxs(_components.td,{children:[`Die API-Abrechnung ist nicht aktiv, oder Ihre Organisation hat keinen aktiven kostenpflichtigen Tarif. Prüfen Sie den Status der `,_jsx(_components.strong,{children:`API-Abrechnung`}),` auf der Registerkarte `,_jsx(_components.strong,{children:`Abrechnung`}),` und eventuelle Hinweise oben auf der API-Seite.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_MODEL_NOT_ALLOWED`})}),_jsxs(_components.td,{children:[`Der Schlüssel hat keinen Zugriff auf dieses Modell. Geben Sie die `,_jsx(_components.strong,{children:`API-Modell-ID`}),` genau so an, wie sie angezeigt wird, und prüfen Sie, ob der Schlüssel das Modell enthält.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_REQUEST_INVALID`})}),_jsxs(_components.td,{children:[`Der Anfragetext ist kein gültiges JSON, der Header `,_jsx(_components.code,{children:`Content-Type: application/json`}),` fehlt oder `,_jsx(_components.code,{children:`model`}),` fehlt. Prüfen Sie Anführungszeichen und Header.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_REQUEST_UNBOUNDED`})}),_jsxs(_components.td,{children:[`Die Anfrage enthält ein nicht unterstütztes Feld oder einen unzulässigen Wert, zum Beispiel `,_jsx(_components.code,{children:`response_format`}),` oder eine `,_jsx(_components.code,{children:`temperature`}),` über 2.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_ENDPOINT_NOT_FOUND`})}),_jsxs(_components.td,{children:[`Der Pfad wird nicht unterstützt. Prüfen Sie, ob Ihre Basis-URL genau `,_jsx(_components.code,{children:`https://api.deepmask.io/v1`}),` lautet, und rufen Sie `,_jsx(_components.code,{children:`/v1/chat/completions`}),` ohne abschließenden Schrägstrich auf. Ein Pfad außerhalb von `,_jsx(_components.code,{children:`/v1/`}),` gibt `,_jsx(_components.code,{children:`404`}),` mit leerem Body zurück.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`API_CONCURRENCY_LIMIT`}),`, `,_jsx(_components.code,{children:`API_RPM_LIMIT`}),`, `,_jsx(_components.code,{children:`API_TPM_LIMIT`}),`, `,_jsx(_components.code,{children:`API_RATE_LIMIT`}),`, `,_jsx(_components.code,{children:`API_MODEL_CAPACITY`})]}),_jsxs(_components.td,{children:[`Sie haben ein Limit erreicht. Die meisten Limits gelten für alle Schlüssel Ihrer Organisation gemeinsam. Jeder Schlüssel hat außerdem einige eigene Limits. Siehe `,_jsx(_components.strong,{children:`API-Limits`}),` auf der Registerkarte `,_jsx(_components.strong,{children:`Nutzung`}),` und `,_jsx(_components.a,{href:`/de/api/limits#limits-im-%C3%BCberblick`,children:`Limits im Überblick`}),`. `,_jsx(_components.code,{children:`API_MODEL_CAPACITY`}),` bedeutet, dass das Modell sein Kapazitätslimit erreicht hat, das sich alle Organisationen teilen. Warten Sie kurz und versuchen Sie es erneut, oder verwenden Sie ein anderes Modell.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_ADMISSION_UNAVAILABLE`})}),_jsxs(_components.td,{children:[`DeepMask kann gerade keine Anfragen für Ihre Organisation annehmen. Warten Sie eine Minute und versuchen Sie es erneut. Tritt der Fehler weiterhin auf, prüfen Sie den Hinweis oben auf der API-Seite. Steht dort, dass Anfragen pausiert sind, wiederholen Sie Anfragen nicht in einer Schleife. Siehe `,_jsx(_components.a,{href:`/de/api/errors#wann-anfragen-pausiert-werden`,children:`Wann Anfragen pausiert werden`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{\"data-numeric\":`true`,children:[_jsx(_components.code,{children:`503`}),`, `,_jsx(_components.code,{children:`504`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_INFERENCE_UNAVAILABLE`})}),_jsxs(_components.td,{children:[`DeepMask konnte keine Antwort vom Modell erhalten. Ihnen wird nichts berechnet, es sei denn, für die Anfrage wird später doch noch Nutzung erfasst. Wiederholen Sie die Anfrage mit Backoff, senden Sie sie aber nicht in einer Schleife erneut. Mehr als 20 solcher Fehler innerhalb von 24 Stunden pausieren die Anfragen Ihrer Organisation. Siehe `,_jsx(_components.a,{href:`/de/api/limits#unklare-ergebnisse`,children:`Unklare Ergebnisse`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Welche Modelle Ihr Schlüssel verwenden darf, erfahren Sie mit `,_jsx(_components.code,{children:`GET /v1/models`}),`. Der Aufruf gibt nur die Modelle zurück, die für diesen Schlüssel freigegeben sind:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.deepmask.io/v1/models`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$DEEPMASK_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Alle weiteren Codes, auch Ablehnungen wegen eines Ausgabenlimits, finden Sie unter `,_jsx(_components.a,{href:`/de/api/errors`,children:`Fehler und Wiederholungen`}),`. Alle Limits finden Sie unter `,_jsx(_components.a,{href:`/de/api/limits`,children:`Limits und faire Nutzung`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`nächste-schritte`,children:`Nächste Schritte`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`API-Schlüssel verwalten`,icon:`key`,href:`/de/api/keys`,children:_jsx(_components.p,{children:`Erstellen Sie Schlüssel pro App oder Umgebung, prüfen Sie ihren Status und widerrufen Sie Schlüssel, die Sie nicht mehr benötigen.`})}),_jsx(Card,{title:`Ausgabenlimits festlegen`,icon:`gauge`,href:`/de/api/spending-caps`,children:_jsx(_components.p,{children:`Steuern Sie die monatlichen Modellkosten mit dem organisationsweiten Limit und optionalen Limits pro Schlüssel.`})}),_jsx(Card,{title:`Referenz zu Chat Completions`,icon:`code`,href:`/de/api/chat-completions`,children:_jsx(_components.p,{children:`Lernen Sie die unterstützten Anfragefelder, Streaming, Tool-Aufrufe und das Antwortformat kennen.`})}),_jsx(Card,{title:`Modelle und Preise`,icon:`list`,href:`/de/api/models`,children:_jsx(_components.p,{children:`Durchsuchen Sie die API-Modelle, finden Sie ihre Modell-IDs und erfahren Sie, wie die Preise pro Token funktionieren.`})}),_jsx(Card,{title:`Limits und faire Nutzung`,icon:`sliders`,href:`/de/api/limits`,children:_jsx(_components.p,{children:`Prüfen Sie die Raten-, Token- und Budgetlimits, die für Ihre Anfragen gelten.`})}),_jsx(Card,{title:`Fehler und Wiederholungen`,icon:`triangle-exclamation`,href:`/de/api/errors`,children:_jsx(_components.p,{children:`Erfahren Sie, was Fehlercodes bedeuten, welche Fehler Sie wiederholen sollten und wie Sie mit abgelehnten Anfragen umgehen.`})}),_jsx(Card,{title:`Nutzung und Protokolle`,icon:`chart-line`,href:`/de/api/usage-and-logs`,children:_jsx(_components.p,{children:`Verfolgen Sie die monatlichen Kosten, prüfen Sie Ihre API-Limits und sehen Sie sich Ihre Anfragen an.`})}),_jsx(Card,{title:`Abrechnung`,icon:`receipt`,href:`/de/api/billing`,children:_jsx(_components.p,{children:`Erfahren Sie, wie sich Ihre monatliche API-Rechnung zusammensetzt, rufen Sie Rechnungen ab und beenden Sie bei Bedarf die API-Abrechnung.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"API-Schnellstart","sidebarTitle":"Schnellstart","description":"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.","keywords":["API","Schnellstart","API-Schlüssel","Chat Completions","OpenAI-kompatibel","OpenAI-SDK","cURL","Python","Node.js","API-Abrechnung"],"href":"/de/api/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Voraussetzungen","slug":"voraussetzungen","depth":2,"children":[]},{"title":"Zugriff einrichten und eine Testanfrage senden","slug":"zugriff-einrichten-und-eine-testanfrage-senden","depth":2,"children":[]},{"title":"Ihre erste Anfrage senden","slug":"ihre-erste-anfrage-senden","depth":2,"children":[]},{"title":"Die Antwort auswerten","slug":"die-antwort-auswerten","depth":2,"children":[]},{"title":"Wenn Ihre erste Anfrage fehlschlägt","slug":"wenn-ihre-erste-anfrage-fehlschlägt","depth":2,"children":[]},{"title":"Nächste Schritte","slug":"nächste-schritte","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"deepmaskgmbh","siteName":"DeepMask","title":"API-Schnellstart - DeepMask","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/quickstart","matchLevel":1},"de":{"href":"/de/api/quickstart","matchLevel":0}}},"lastModified":"2026-11-16T16:01:24.588Z","originalFileLocation":"de/api/quickstart.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DeepMask\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API-Schnellstart - DeepMask\">\u003cmeta data-mint-head property=\"og:description\" content=\"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DeepMask\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.deepmask.io/de/api/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://deepmaskgmbh.mintlify.site/_mintlify/api/og/v2?division=Erste+Schritte\u0026amp;title=API-Schnellstart\u0026amp;description=Aktivieren+Sie+die+API-Abrechnung%2C+erstellen+Sie+Ihren+ersten+API-Schl%C3%BCssel+und+senden+Sie+aus+Ihrem+eigenen+Code+eine+Chat-Completion-Anfrage+an+DeepMask-Model\u0026amp;theme=e567b27b7b33e40a3da35b7a\u0026amp;signature=8e5ddce92b2e251b53b3e4c87d85d224a865420133eaf6d63c59ae0464d5190d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"API-Schnellstart - DeepMask\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://deepmaskgmbh.mintlify.site/_mintlify/api/og/v2?division=Erste+Schritte\u0026amp;title=API-Schnellstart\u0026amp;description=Aktivieren+Sie+die+API-Abrechnung%2C+erstellen+Sie+Ihren+ersten+API-Schl%C3%BCssel+und+senden+Sie+aus+Ihrem+eigenen+Code+eine+Chat-Completion-Anfrage+an+DeepMask-Model\u0026amp;theme=e567b27b7b33e40a3da35b7a\u0026amp;signature=8e5ddce92b2e251b53b3e4c87d85d224a865420133eaf6d63c59ae0464d5190d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/deepmaskgmbh/hwlc6glwRXpXRbmg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DeepMask\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#139058\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.deepmask.io/de/api/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/de/api/quickstart.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://documentation.deepmask.io/de/api/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.deepmask.io/api/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.deepmask.io/api/quickstart\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.deepmask.io/#organization\",\"name\":\"DeepMask\",\"url\":\"https://documentation.deepmask.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/deepmaskgmbh/wqYs4HgxrHF-vtoI/images/light-theme-logo-B6Sj8q9n.svg?fit=max\u0026auto=format\u0026n=wqYs4HgxrHF-vtoI\u0026q=85\u0026s=b2e82def8bcaaf56f11738b4e22b9748\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.deepmask.io#website\",\"name\":\"DeepMask\",\"url\":\"https://documentation.deepmask.io\",\"publisher\":{\"@id\":\"https://documentation.deepmask.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.deepmask.io/de/api/quickstart#webpage\",\"url\":\"https://documentation.deepmask.io/de/api/quickstart\",\"name\":\"API-Schnellstart\",\"description\":\"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\",\"dateModified\":\"2026-11-16T16:01:24.588Z\",\"isPartOf\":{\"@id\":\"https://documentation.deepmask.io#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.deepmask.io/de/api/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.deepmask.io/de/api/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Erste Schritte\",\"item\":\"https://documentation.deepmask.io/de/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API-Schnellstart\",\"item\":\"https://documentation.deepmask.io/de/api/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.deepmask.io/de/api/quickstart#article\",\"headline\":\"API-Schnellstart\",\"name\":\"API-Schnellstart\",\"description\":\"Aktivieren Sie die API-Abrechnung, erstellen Sie Ihren ersten API-Schlüssel und senden Sie aus Ihrem eigenen Code eine Chat-Completion-Anfrage an DeepMask-Modelle.\",\"url\":\"https://documentation.deepmask.io/de/api/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.deepmask.io/de/api/quickstart#webpage\"},\"dateModified\":\"2026-11-16T16:01:24.588Z\",\"keywords\":\"API, Schnellstart, API-Schlüssel, Chat Completions, OpenAI-kompatibel, OpenAI-SDK, cURL, Python, Node.js, API-Abrechnung\",\"publisher\":{\"@id\":\"https://documentation.deepmask.io/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.deepmask.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DeepMask\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DeepMask\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/de/api/quickstart.md","siteName":"DeepMask","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/api/quickstart"}]},{"language":"de","tabs":[{"tab":"Dokumentation","pages":[{"title":"Dokumentation","href":"/de/introduction"}]},{"tab":"Modelle","pages":[{"title":"Modelle","href":"/de/models/overview"}]},{"tab":"API","groups":[{"group":"Erste Schritte","pages":[{"title":"DeepMask API","sidebarTitle":"Übersicht","description":"Nutzen Sie DeepMask-Modelle in Ihren eigenen Anwendungen und Skripten über eine OpenAI-kompatible API mit Abrechnung nach Verbrauch.","href":"/de/api/overview"},{"title":"API-Schnellstart","sidebarTitle":"Schnellstart","href":"/de/api/quickstart"}]},{"group":"Verwaltung","pages":[{"title":"API-Schlüssel","sidebarTitle":"API-Schlüssel","description":"Erstellen Sie API-Schlüssel für Ihre Organisation, legen Sie fest, welche Modelle jeder Schlüssel nutzen darf, und widerrufen Sie Schlüssel, die Sie nicht mehr benötigen.","href":"/de/api/keys"},{"title":"Ausgabenlimits","sidebarTitle":"Ausgabenlimits","href":"/de/api/spending-caps"},{"title":"Nutzung und Anfrageprotokolle","sidebarTitle":"Nutzung und Protokolle","href":"/de/api/usage-and-logs"},{"title":"API-Abrechnung","sidebarTitle":"Abrechnung","href":"/de/api/billing"}]},{"group":"Referenz","pages":[{"title":"API-Modelle","sidebarTitle":"Modelle","href":"/de/api/models"},{"title":"Chat Completions","sidebarTitle":"Chat Completions","href":"/de/api/chat-completions"},{"title":"Limits und faire Nutzung","sidebarTitle":"Limits und faire Nutzung","href":"/de/api/limits"},{"title":"Fehler und Wiederholungen","sidebarTitle":"Fehler und Wiederholungen","href":"/de/api/errors"}]}]}]}]},"basePath":"","title":"API-Schnellstart - DeepMask","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}