Anthropic-Integration

Noirdoc mit dem Anthropic Python- und Node.js-SDK nutzen.

Überblick

Noirdoc unterstützt die Anthropic Messages API vollstaendig. Die Integration erfordert nur das Aendern der Base-URL und des API-Keys in Ihrer bestehenden SDK-Konfiguration.

Wichtig: Im Gegensatz zur OpenAI-Integration wird bei Anthropic kein /v1-Suffix an die Base-URL angehaengt. Die korrekte Base-URL lautet:

https://api.noirdoc.de

Das Anthropic SDK fuegt den Pfad /v1/messages automatisch hinzu. Wenn Sie faelschlicherweise https://api.noirdoc.de/v1 verwenden, erhalten Sie einen 404-Fehler.

Python — Messages API

Installieren Sie das Anthropic Python-SDK und konfigurieren Sie den Client:

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.noirdoc.de",
    api_key="px-your-noirdoc-key",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Fasse den Vertrag für Max Mustermann, geboren am 15.03.1985, zusammen."
        }
    ],
)

print(message.content[0].text)

Noirdoc erkennt die personenbezogenen Daten im Prompt, pseudonymisiert sie vor der Weiterleitung an Anthropic und stellt die Originalwerte in der Antwort wieder her.

Node.js — Messages API

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.noirdoc.de",
  apiKey: "px-your-noirdoc-key",
});

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: "Erstelle eine Zusammenfassung der Patientenakte von Dr. Anna Weber.",
    },
  ],
});

console.log(message.content[0].text);

Streaming

Streaming wird vollstaendig unterstützt. Die Pseudonyme werden in Echtzeit wiederhergestellt. Siehe Streaming für SDK-Beispiele und SSE-Details.

Authentifizierung

Anthropic verwendet den Header x-api-key statt Authorization: Bearer. Das SDK setzt diesen Header automatisch. Bei direkten HTTP-Anfragen (z.B. mit cURL) verwenden Sie:

curl https://api.noirdoc.de/v1/messages \
  -H "x-api-key: px-your-noirdoc-key" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":[{"role":"user","content":"Hallo"}]}'

Hinweise

• Base-URL ohne /v1: https://api.noirdoc.de — das ist der häufigste Konfigurationsfehler.
• Alle Claude-Modelle werden unterstützt, einschliesslich claude-sonnet-4-6 und claude-haiku-4-5-20251001.
• System-Prompts, Tool-Nutzung und Vision-Anfragen funktionieren transparent durch den Proxy.
• Der anthropic-version-Header wird unveraendert an Anthropic weitergeleitet.