Zum Inhalt springen
DeutschlandGPT

Schnellstart

API-Schlüssel anlegen, Guthaben aufladen und den ersten Aufruf an die Platform API senden.

1

Platform API öffnen

Melden Sie sich an und öffnen Sie die Platform API. Ihr Workspace existiert bereits: Er wird beim ersten Besuch automatisch angelegt und enthält Guthaben, Zahlungsmethoden und API-Schlüssel. In einer Organisation teilen sich alle Mitglieder den Workspace der Organisation.

Die Übersicht zeigt eine Checkliste Erste Schritte mit den nächsten Schritten.

2

Guthaben aufladen

Bei einem vorausbezahlten Workspace laufen Anfragen nur, solange Guthaben vorhanden ist. Öffnen Sie die Abrechnung, klicken Sie auf Guthaben kaufen und wählen Sie ein Paket oder einen eigenen Betrag. Als Standardzahlungsmethode brauchen Sie eine Kredit- oder Debitkarte. Die Preise verstehen sich zzgl. MwSt. Vor der Zahlung bestätigen Sie die Bedingungen und verzichten auf Ihr Widerrufsrecht.

Dort können Sie auch Automatisches Aufladen einschalten, damit sich das Guthaben selbst auffüllt. Einzelheiten unter Abrechnung.

Wird Ihre Organisation per Rechnung abgerechnet, überspringen Sie diesen Schritt.

3

API-Schlüssel erstellen

Öffnen Sie API-Schlüssel, klicken Sie auf API-Schlüssel hinzufügen und vergeben Sie einen aussagekräftigen Namen, etwa produktion oder dev-test.

Dialog zum Anlegen eines API-Schlüssels mit Modellauswahl, Berechtigungen und Ausgabenlimit

Prüfen Sie die Voreinstellungen, bevor Sie auf API-Schlüssel erstellen klicken:

  • Der Schlüssel darf alle Modelle nutzen, aber Nur DSGVO-konforme Modelle (in der EU/DE gehostet) ist eingeschaltet.
  • Der Schlüssel hat Zugriff auf keine Dokumentenordner und keine Spezialanwendungen. Wählen Sie aus, was er braucht.
  • Ein Ausgabenlimit gibt es nur, wenn Sie es aktivieren.

Der vollständige Schlüssel erscheint einmalig unter Schlüssel speichern. Kopieren Sie ihn und bewahren Sie ihn sicher auf. Er lässt sich nicht erneut anzeigen. Geht er verloren, legen Sie einen neuen Schlüssel an und löschen den alten.

4

Ersten Aufruf machen

Verwenden Sie den API-Schlüssel als Bearer-Token im Authorization-Header. Die Base URL hängt von Ihrer Bereitstellung ab. Beim gehosteten Dienst ist sie https://api.deutschlandgpt.de/v2, eine selbst gehostete Instanz verwendet https://<ihre-domain>/platform-api/api/v2.

bash

Eine erfolgreiche Antwort sieht so aus:

JSON
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1712000000,
  "model": "claude-sonnet-4.6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hallo! Wie kann ich Ihnen helfen?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 9,
    "total_tokens": 18
  }
}

Fehler: 402 Payment Required

Ein 402 bedeutet, dass die Anfrage nicht bezahlt werden konnte. Bei einem vorausbezahlten Workspace ist das Guthaben aufgebraucht oder das monatliche Limit des Workspace erreicht. Laden Sie in der Abrechnung Guthaben auf oder erhöhen Sie das Limit unter Budgets & Limits. Weitere Gründe stehen unter Streaming, Tools und strukturierte Ausgabe.

Nächste Schritte

  • Chat Completions: vollständige Parameterreferenz, Streaming, Function Calling.
  • Modelle: sehen, welche Modelle Ihr Schlüssel nutzen darf.
  • Abrechnung: Guthaben, automatisches Aufladen, Ausgabenlimits.
War diese Seite hilfreich?