innoGPT API — Einführung & Quickstart

Die innoGPT API ist eine OpenAI-kompatible Enterprise-API mit Zugriff auf 50+ KI-Modelle — alles über einen einzigen API-Key, vollständig DSGVO-konform und EU-gehostet.

💡 Gut zu wissen: Alle Inhalte dieser Dokumentation und noch mehr Infos findest du auch direkt in deinem innoGPT-Account unter Einstellungen → API-Keys → Dokumentation. Dort hast du zusätzlich Zugriff auf die interaktive Swagger-UI zum Live-Testen aller Endpoints.

Was ist die innoGPT API?

Eine einheitliche Schnittstelle, mit der du:

  • 50+ KI-Modelle über einen einzigen Endpoint nutzt (GPT-5, Claude 4.6, Gemini 2.5, Mistral, …)

  • Dein bestehendes OpenAI SDK weiterverwendest — nur Base-URL ändern

  • DSGVO-konform und EU-gehostet arbeitest

  • Auf Built-in-Tools zugreifst (Websuche, Code-Execution, RAG, …)

  • Mit Projekten und Assistenten aus deinem Workspace per API arbeitest

Base-URL

https://app.innogpt.de/api/ext/v1

OpenAI-Kompatibilität

Du nutzt bereits das OpenAI SDK? Tausch einfach die Base-URL — der Rest bleibt identisch:

from openai import OpenAI

client = OpenAI(
    api_key="sk_live_dein_key",
    base_url="https://app.innogpt.de/api/ext/v1"
)

response = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Hallo!"}]
)

Funktioniert genauso mit Node.js, Go, Java und allen anderen OpenAI-kompatiblen SDKs.

Quickstart in 5 Minuten

Schritt 1: API-Key erstellen

  1. Logg dich in deinen innoGPT-Account ein

  2. Geh zu Einstellungen → API-Keys

  3. Klick auf Neuen API-Key erstellen

  4. Vergib einen Namen (z. B. „Produktion Backend")

  5. ⚠️ Setze ein monatliches Limit — schützt vor Überverbrauch und Missbrauch

  6. Kopiere den Key sofort — er wird nur einmal angezeigt

Schritt 2: Erste Anfrage senden

curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  https://app.innogpt.de/api/ext/v1/chat/completions \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "system", "content": "Du bist ein hilfreicher Assistent"},
      {"role": "user", "content": "Hallo!"}
    ],
    "temperature": 0.3
  }'

Schritt 3: Streaming aktivieren

Für Echtzeit-Antworten (Token-für-Token):

curl -N -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  https://app.innogpt.de/api/ext/v1/chat/completions \
  -d '{
    "model": "gpt-5",
    "messages": [{"role": "user", "content": "Stream bitte"}],
    "stream": true
  }'

Endpoints im Überblick

EndpointZweck

POST /chat/completions

Chat-Anfragen (OpenAI-kompatibel)

POST /embeddings

Text-Embeddings generieren

POST /images/generations

Bilder generieren

POST /responses

Tool-Calling, Streaming, Background-Tasks

GET /models

Verfügbare Modelle auflisten

POST /webhooks

Webhooks für Events einrichten

→ Vollständige Referenz: Artikel 7 — API-Referenz

Antwort-Header

Jede Antwort enthält nützliche Header:

HeaderBeschreibung

X-Request-Id

Eindeutige Request-ID (für Support)

X-RateLimit-Limit

Maximale Anfragen pro Periode

X-RateLimit-Remaining

Verbleibende Anfragen

X-RateLimit-Reset

Zeitpunkt, wann das Limit zurückgesetzt wird

X-Budget-Limit

Monatliches Budgetlimit (falls konfiguriert)

X-Budget-Remaining

Verbleibendes Budget

Debugging-Tipp: Bei Fehlern immer die X-Request-Id mitschicken, wenn du Support kontaktierst.

Brauchst du Hilfe?

Schreib uns — wir antworten in der Regel innerhalb eines Werktags.