Schnellstart

Workspace erstellen

Ein Workspace ist Ihr Abrechnungscontainer für die Platform API. Er enthält Ihr Guthaben, Zahlungsmethoden und API-Schlüssel. Er muss erstellt werden, bevor API-Aufrufe möglich sind.

Melden Sie sich in der Anwendung an und wechseln Sie zum Platform-API-Bereich. Folgen Sie dem Einrichtungsassistenten, um Ihren Workspace zu erstellen und zu benennen.

Guthaben aufladen

Die Platform API basiert auf Guthaben — Sie benötigen ein positives Guthaben, bevor Anfragen verarbeitet werden.

Gehen Sie zu Abrechnung → Guthaben und erwerben Sie ein Guthabenpaket oder geben Sie einen individuellen Betrag ein. Die Zahlung erfolgt über Stripe mit Ihrer hinterlegten Zahlungsmethode.

Hier können Sie auch die automatische Aufladung aktivieren, damit Ihr Guthaben automatisch aufgefüllt wird, wenn es unter einen von Ihnen festgelegten Schwellenwert fällt. Weitere Details unter Abrechnung.

API-Schlüssel erstellen

Gehen Sie zu Dashboard → API-Schlüssel und klicken Sie auf Neuer API-Schlüssel. Vergeben Sie einen aussagekräftigen Namen (z. B. produktion, dev-test).

Der vollständige Schlüssel wird einmalig nach der Erstellung angezeigt. Kopieren Sie ihn und speichern Sie ihn sicher — er kann nicht erneut abgerufen werden. Wenn Sie ihn verlieren, erstellen Sie einen neuen Schlüssel und archivieren den alten.

Ersten Aufruf machen

Verwenden Sie den API-Schlüssel als Bearer-Token im Authorization-Header. Die Base URL passt sich Ihrer Bereitstellung an — beim gehosteten Dienst ist sie https://api.deutschlandgpt.de/v2; eine selbst gehostete Instanz verwendet https://<ihre-domain>/platform-api/api/v2.

Eine erfolgreiche Antwort sieht so aus:

{
  "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
  }
}