Schnellstart

Was ist Noirdoc?

Noirdoc ist eine Schnittstelle zu allen KI-Modellen — ein OpenAI-kompatibler Endpoint unter https://api.noirdoc.de/v1. Sie wählen ein Modell, senden eine Anfrage und erhalten eine Antwort. Kein eigener Provider-Account, keine neuen Verträge: Die Plattform stellt die verwalteten Modelle bereit, souverän in Deutschland betrieben.

Bei Bedarf pseudonymisiert Noirdoc personenbezogene Daten, bevor sie ein Modell erreichen — die Maskierung ist ein optionales Feature, das Sie aktivieren können. Mehr dazu unter Maskierung.

Voraussetzungen

Sie brauchen nur einen Noirdoc-API-Key (beginnt mit px-). Erstellen Sie ihn im Noirdoc-Portal oder bitten Sie den Administrator Ihrer Organisation darum. Das px--Präfix unterscheidet ihn klar von Provider-Keys; derselbe Key funktioniert für alle Anfragen.

Drei Schritte — kein SDK-Zwang, kein Code-Umbau.

1. Noirdoc-API-Key besorgen

Melden Sie sich im Portal an und erstellen Sie unter API-Schlüssel einen Key. Jeder Key beginnt mit px-.

2. Erste Anfrage senden

curl https://api.noirdoc.de/v1/chat/completions \
  -H "Authorization: Bearer px-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model-id>",
    "messages": [{"role": "user", "content": "Hallo"}]
  }'

Mit dem OpenAI-SDK genügt es, base_url und api_key zu tauschen — der restliche Code bleibt unverändert:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.noirdoc.de/v1",
    api_key="px-...",
)

response = client.chat.completions.create(
    model="<model-id>",
    messages=[{"role": "user", "content": "Hallo"}],
)

print(response.choices[0].message.content)

Jede Bibliothek, die eine benutzerdefinierte Base-URL unterstützt, funktioniert genauso — LangChain, LlamaIndex, Node.js-Clients und mehr.

3. Fertig

Mehr ist nicht nötig. Ihre Anfrage läuft über den Noirdoc-Endpoint an das gewählte Modell.

Modellverfügbarkeit

Welche Modelle Ihnen zur Verfügung stehen, liefert der Katalog-Endpunkt:

curl https://api.noirdoc.de/v1/models \
  -H "Authorization: Bearer px-..."

Verwenden Sie eine der zurückgegebenen Modell-IDs als model-Parameter. Dieselbe Liste zeigt auch das Portal.

Eigener Provider-Key (BYOK)

Statt der verwalteten Modelle können Sie Ihren eigenen Provider-Key verwenden (OpenAI, Anthropic, Azure OpenAI, OpenRouter). Hinterlegen Sie ihn im Portal — Noirdoc routet die Anfrage dann über Ihren Provider und Ihr Key wird nie für Ihren Anwendungscode sichtbar. Ist ein eigener Key hinterlegt, hat er Vorrang; andernfalls greifen die verwalteten Plattform-Modelle. Anfragen im Anthropic-Format (/v1/messages) laufen ausschließlich über eigene Keys.

PII-Maskierung

Optional pseudonymisiert Noirdoc personenbezogene Daten — Namen, E-Mail-Adressen, Telefonnummern, IBANs und mehr — bevor das Modell sie sieht, und stellt sie in der Antwort wieder her. Die Maskierung ist standardmäßig deaktiviert und lässt sich pro Anfrage oder per Richtlinie aktivieren — siehe Maskierung.

Nächste Schritte

Maskierung — wie die Pseudonymisierung funktioniert und wie Sie sie pro Anfrage steuern
API-Referenz — Authentifizierung, Endpunkte, Streaming und Fehlercodes

Weiter Übersicht