Quickstart

Create a workspace

A workspace is your billing container for the Platform API. It holds your credits, payment methods, and API keys. You must create one before you can make any API calls.

Sign in at the application, then go to the Platform API section. Follow the on-screen prompt to create your workspace and give it a name.

Add credits

The Platform API is credit-based — you need a positive balance before requests are processed.

Go to Billing → Credits and purchase a credit package or enter a custom amount. Credits are charged to your saved payment method via Stripe.

You can also enable auto top-up here, so your balance is automatically refilled when it drops below a threshold you set. See Billing for details.

Create an API key

Go to Dashboard → API Keys and click New API Key. Give it a descriptive name (e.g. production, dev-testing).

The full key is displayed once immediately after creation. Copy it and store it securely — it cannot be retrieved again. If you lose it, create a new key and archive the old one.

Make your first request

Use the API key as a Bearer token in the Authorization header. The base URL adapts to your deployment — on the hosted service it is https://api.deutschlandgpt.de/v2; a self-hosted instance uses https://<your-domain>/platform-api/api/v2.

A successful response looks like:

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1712000000,
  "model": "claude-sonnet-4.6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 9,
    "total_tokens": 18
  }
}