SovrGPT Docs

Getting started with SovrGPT

SovrGPT quick start in five minutes: sign up with an email code, start your first chat, create an API key and make your first API call.

From account to first API call in a few minutes. All you need is an email address.

1. Create an account

  1. Open sovrgpt.com/login and enter your email address.
  2. Enter the six-digit code from the email. Your account is created automatically; no credit card needed.
  3. Optionally set a password, so you can also sign in without a code later.

2. Start your first chat

  1. Open sovrgpt.com/chat. New chats start with Auto: SovrGPT classifies your first message (everyday, reasoning, programming, interactive app) and picks a model for it with no wait.
  2. Type your question. Tools such as web search, image, video or file are switched on in the bar at the input field.
  3. Change the model in the model picker, per chat. Which model suits which job is covered in Models.

Web search is off by default. It sends search queries to Brave Search, a provider based in the USA.

Self-hosted models such as gemma-4-12b scale down after a pause. The first answer afterwards takes 3 to 15 minutes depending on the model (cold start). Models whose ID starts with tensorx-… or stackit-… have no cold start.

3. Create an API key

  1. Open API-Keys in the sidebar (sovrgpt.com/settings/api-keys).
  2. Give it a name, restrict permissions if needed, click "+ Neuen Key erzeugen" (create new key).
  3. Copy the key immediately. It is shown only once.

The key belongs to the organisation that is currently active.

4. Your first API call

curl https://sovrgpt.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SOVR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma-4-12b",
    "messages": [{ "role": "user", "content": "Hello SovrGPT!" }]
  }'

If gemma-4-12b is cold, the answer takes a few minutes. For no wait, use "model": "stackit-qwen3.8-27b" (operated in Germany). Everything else is in the API reference.

5. Invite your team (optional)

Organisation switcher at the top of the sidebar → "+ Neue Team-Organisation" (new team organisation), then invite people under Org & Mitglieder (org & members). More in Organisations & teams.

6. Excel add-in (optional)

SovrGPT also works as a sidebar in Excel: you describe what should happen in the workbook, and nothing is written until you approve it.

  1. On sovrgpt.com/en/excel, download the installation file and double-click it.
  2. Close Excel completely (every window) and reopen it.
  3. In Excel, open Home → Add-ins, select SovrGPT für Excel and press Add.

In companies and public authorities, IT deploys the add-in centrally. Everything else is in Excel add-in.

Common pitfalls

  • The first answer takes minutes: cold start. Follow-up requests are fast.
  • Lost API key: it cannot be shown again. Create a new one, revoke the old one.
  • 404 model_not_found: the model ID is wrong or hidden in your organisation. GET /v1/models shows what your key may use.
  • Old model ID: withdrawn models are answered by the default model, marked by the x-sovrgpt-model-substituted header (Chat Completions).
Getting started with SovrGPT