Zum Inhalt springen
DeutschlandGPT

Platform API

Eine OpenAI-kompatible REST-API, die die KI-Modelle von DeutschlandGPT in Ihre eigenen Anwendungen bringt, gehostet auf deutscher Infrastruktur.

Mit der DeutschlandGPT Platform API greift Ihre eigene Software auf dieselben KI-Modelle zu wie der Chat: Textgenerierung, Embeddings, Bilder, Video, Avatar-Video, Sprachausgabe und Transkription. Sie spricht das Wire-Format von OpenAI und, für Claude Code und das Anthropic-SDK, das von Anthropic.

Base URLs für Ihre Bereitstellung: https://api.deutschlandgpt.de/v2 für die OpenAI-kompatiblen Endpunkte, https://api.deutschlandgpt.de/anthropic für die Anthropic-kompatiblen. Beide liegen auf derselben Ebene, die Anthropic-Base-URL also nie unterhalb von /v2.

SchnittstelleGehostetSelbst gehostet
OpenAI-kompatibelhttps://api.deutschlandgpt.de/v2https://<ihre-domain>/platform-api/api/v2
Anthropic-kompatibelhttps://api.deutschlandgpt.de/anthropichttps://<ihre-domain>/platform-api/api/anthropic

Hängen Sie den Endpunktpfad an die OpenAI-kompatible Base URL an, zum Beispiel /chat/completions. Das Anthropic-SDK ergänzt /v1/messages selbst.

Funktionsumfang

  • Chat Completions und Responses: Nachrichten senden und Antworten erhalten, mit Streaming, Function Calling und strukturierter Ausgabe, über /chat/completions oder /responses.
  • Anthropic Messages: ein nativer Anthropic-Messages-Endpunkt, sodass Anthropic-SDK und Claude Code unverändert mit jedem gehosteten Modell funktionieren.
  • Websuche: eine Live-Websuche ausführen und gerankte Treffer mit Titel, URL und Ausschnitt erhalten.
  • Embeddings: Text in Vektoren umwandeln, für semantische Suche, Klassifikation und Clustering.
  • Bilder: Bilder aus einem Prompt erzeugen oder bestehende Bilder bearbeiten.
  • Video und Avatar-Video: kurze Videos aus einem Prompt erzeugen oder sprechende Avatare aus einem Skript. Einen eigenen Avatar legen Sie aus einem Foto an. Beide Videoarten laufen als asynchroner Job, dessen Status Sie abfragen.
  • Sprachausgabe, Stimmen und Musik: Text in Audio umwandeln, eine Stimme aus Audioproben klonen und Musik aus einem Prompt erzeugen.
  • Transkription: Audiodateien in Text umwandeln, auf Wunsch mit Sprachhinweis.
  • Dokumentenordner: Ordner anlegen, Dateien hochladen und die Dokumente Ihrer Organisation semantisch durchsuchen.
  • Spezialanwendungen: Spezialanwendungen (Custom GPTs) mit eigenen Anweisungen, Dateien und Modelleinstellungen anlegen und verwalten.
  • Berechtigungen für API-Schlüssel: Schlüssel auf bestimmte Modelle, Ordner und Spezialanwendungen beschränken, mit Ausgabenlimits.
  • Admin-Analysen: die Nutzung im Workspace nach Tag, Modell und Schlüssel auswerten.

Welche Modelle Ihr Workspace nutzen darf, verrät der Endpunkt Modelle.

Wer die API nutzen darf

In einer Organisation braucht die Platform API die Rollenberechtigung Platform API nutzen und API-Schlüssel verwalten. Für den Kauf von Guthaben und das Ändern von Ausgabenlimits ist Guthaben und Ausgabenlimits verwalten nötig. Beide vergibt Ihre Administration in den Rolleneinstellungen.

Abrechnung

Jede Anfrage kostet Geld, abhängig vom Modell und von den verbrauchten Tokens, Bildern oder Sekunden. Die Kosten gehen auf Ihren Workspace. Er enthält Guthaben, Zahlungsmethoden und API-Schlüssel. Anlegen müssen Sie ihn nicht: Er entsteht automatisch, sobald Sie die Platform API zum ersten Mal öffnen. In einer Organisation teilen sich alle Mitglieder einen Workspace.

Die meisten Workspaces sind vorausbezahlt: Sie kaufen Guthaben, und jede Anfrage zieht ihre Kosten davon ab. Manche Organisationen werden stattdessen nach Vereinbarung mit DeutschlandGPT per Rechnung abgerechnet. Einzelheiten zu beidem stehen unter Abrechnung.

Dasselbe Guthaben bezahlt auch den Pay-as-you-go-Chat und Workflows. Die Übersicht der Platform API zeigt unter Verbrauch diesen Monat die Aufteilung nach Produkt, etwa Chat (Pay-as-you-go), API und Workflows.

Die Preise aller Modelle sind öffentlich: Modelle & Preise listet die Preise für Textmodelle, Embeddings und Bilder. Ein Konto brauchen Sie dafür nicht.

Vor dem ersten Aufruf brauchen Sie einen API-Schlüssel und, bei einem vorausbezahlten Workspace, etwas Guthaben. Siehe Schnellstart.

Authentifizierung

Jede Anfrage muss einen Authorization-Header mit einem Bearer-Token enthalten:

CODE
Authorization: Bearer YOUR_API_KEY

API-Schlüssel werden über das Platform-API-Dashboard erstellt und verwaltet.

OpenAI-Kompatibilität

Die API folgt der OpenAI-API-Spezifikation für /chat/completions, /responses, /embeddings, /images/generations, /images/edits, /audio/speech und /audio/transcriptions. Jedes OpenAI-kompatible SDK oder Tool kann mit minimalen Anpassungen auf die DeutschlandGPT-Base-URL umgestellt werden.

Anthropic-Kompatibilität

Die API spricht unter /anthropic/v1/messages auch das Messages-Wire-Format von Anthropic. Richten Sie das Anthropic-SDK oder Claude Code auf https://api.deutschlandgpt.de/anthropic (SDK-Option baseURL oder die Umgebungsvariable ANTHROPIC_BASE_URL) und authentifizieren Sie sich über x-api-key. Damit ist jedes gehostete Modell über dieses Wire-Format erreichbar, nicht nur Claude. Eine selbst gehostete Instanz verwendet https://<ihre-domain>/platform-api/api/anthropic.

Die Anthropic-Base-URL liegt neben /v2, nicht darin. Das SDK ergänzt /v1/messages selbst, deshalb ist https://api.deutschlandgpt.de/anthropic richtig, während https://api.deutschlandgpt.de/v2/anthropic einen 404 liefert.

Siehe Message erstellen für die vollständige Referenz.


War diese Seite hilfreich?