Messages (Anthropic).

Erzeugt Modellantworten im Format der Anthropic Messages API für Claude-Modelle über Google Vertex EU und eigene Anthropic-Anbieter.

Messages.

Nimmt Anfragen im Format der Anthropic Messages API entgegen (base_url="https://api.noirdoc.de" ohne /v1 im Anthropic-SDK) und bedient Claude-Modelle über Google Vertex EU sowie eigene Anthropic-kompatible Anbieter (BYOK).

POST https://api.noirdoc.de/v1/messages

Python
import os
from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.noirdoc.de",
    auth_token=os.environ["NOIRDOC_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Prüfe Klausel 6 im Vertrag."}],
    extra_headers={"X-Noirdoc-Shield": "on"},
)
print(msg.content[0].text)
TypeScript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.noirdoc.de",
  authToken: process.env.NOIRDOC_API_KEY,
});

const msg = await client.messages.create(
  {
    model: "claude-sonnet-5-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Prüfe Klausel 6 im Vertrag." }],
  },
  { headers: { "X-Noirdoc-Shield": "on" } },
);
console.log(msg.content);
curl
curl https://api.noirdoc.de/v1/messages \
  -H "x-api-key: $NOIRDOC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Noirdoc-Shield: on" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Prüfe Klausel 6 im Vertrag."}
    ]
  }'
JSON
// 200 OK · X-Noirdoc-Provider: anthropic-gcp
{
  "id": "msg_01XfdUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    {
      "type": "text",
      "text": "Klausel 6 begrenzt die Haftung auf den Auftragswert.",
    },
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 21,
    "output_tokens": 34,
  },
}

Das Gateway akzeptiert sowohl x-api-key (api_key) als auch Authorization: Bearer (auth_token). Einrichtung für Claude Code unter Claude Code & Werkzeuge.

System-Prompts, Tool-Use, Extended Thinking, Streaming und Prompt-Caching folgen der Anthropic-Spezifikation (2023-06-01). Nur diese Punkte regelt das Gateway anders:

BereichVerhalten bei Noirdoc
modelModell-ID eines Modells im Anthropic-Format aus GET /v1/models (etwa claude-sonnet-5-5 oder claude-haiku-4-5 über Google Vertex EU, oder ein eigener BYOK-Anbieter). Modelle im OpenAI-Format lehnt der Endpunkt mit 400 wrong_endpoint_for_model ab. Im Startguthaben sind nur dafür freigegebene Modelle aufrufbar; nicht freigegebene verwaltete Modelle wie claude-sonnet-5-5 liefern vor der ersten Aufladung 403 starter_model_not_allowed (Guthaben). Im Antwortfeld model setzt das Gateway wieder die von dir gesendete ID ein.
Google Vertex & anthropic-versionAn Anthropic direkt sendet das Gateway immer anthropic-version: 2023-06-01. Auf Google Vertex EU überträgt das Gateway model, Versionskennung und anthropic-beta-Header automatisch in das Vertex-Anfrageformat — dein Aufruf an /v1/messages bleibt unverändert.
Prompt-Cachingcache_control-Markierungen (ephemeral, 5-Minuten- und 1-Stunden-TTL je nach Anbieter) leitet das Gateway unverändert durch. Da Noirdoc Shield feste Platzhalter ([PERSON]) setzt und unveränderte JSON-Segmente bytegenau erhält, bleiben Cache-Präfixe stabil. Cache-Reads und Cache-Writes rechnet das Gateway zu den Katalogpreisen price_cache_read, price_cache_write und price_cache_write_1h ab (Modelle & Preise).
Noirdoc ShieldPrüft system und messages bei aktiver Richtlinie direkt vor Ort ([PERSON], [IBAN], …) ohne Systemanweisung oder Stream-Pufferung; block-Treffer ergeben 403 shield_violation (Geprüfte Felder). Die umkehrbare Maskierung (<<PERSON_1>>) gilt nur noch für Bestandsorganisationen bis zum 30.11.2026 (Klassische Maskierung).
Streaming & Keep-AliveBis zu drei Anbieter-Versuche vor dem ersten Byte; alle 15 Sekunden : ping während der Wartezeit (600 s Gesamtlimit, : provider=<slug> bei vorab gesendetem Status 200). Bricht ein laufender Stream ab, sendet das Gateway ein error-Event gefolgt von event: message_stop (Streaming).
Dateien, Bilder & Verweiseimage- und document-Blöcke erfordern die aktivierte Option Dateianhänge und Bilder in Anfragen erlauben unter Models → Shield (sonst 403 file_content_not_allowed). Eingebettete UTF-8-Textdokumente unter 4 MiB prüft Shield direkt; binäre PDFs und Bilder führen zu X-Noirdoc-Shield: partial; redacted=<n> oder unter enforced zu 422 shield_uninspectable_content. Auf verwalteten Anbietern müssen file-Quellen, Container und eigene Skills in container.skills über deine Organisation entstanden sein (sonst 404 object_not_found, siehe Dateien & Skills).
POST /v1/messages/count_tokensZählt die Eingabe-Tokens für model und messages (wird von Claude Code für genaue Kontextgrößen genutzt und auf Vertex an count-tokens weitergeleitet; lehnt Vertex ab, folgt provider_rejected_request). Überspringt Noirdoc Shield (Maskierung nur im Altbetrieb bis 30.11.2026) und kostet 0 €; bei erschöpftem Organisationsguthaben oder Schlüsselbudget antworten verwaltete Anbieter dennoch mit 402.
Nicht unterstützte UnterroutenMessage Batches (/v1/messages/batches) und alle anderen Pfade unter /v1/messages/ außer /v1/messages/count_tokens beantwortet das Gateway mit 404 unsupported_endpoint. Vor der Weiterleitung entfernt es deinen Schlüssel sowie X-Noirdoc-Shield und X-Noirdoc-Mask.
Status Code Bedeutung
400 invalid_request_path Der Pfad enthält ein Punkt-Segment (. oder ..), ein %, einen Backslash oder ein Steuerzeichen.
400 model_required Die Anfrage nennt kein Modell (model im Body, bei /v1/audio/transcriptions im Formularfeld).
400 wrong_endpoint_for_model Das Modell gehört zu einer anderen Endpunkt-Familie oder einem anderen API-Format als der aufgerufene Endpunkt.
400 invalid_request_body Der Body ist kein JSON-Objekt oder nicht in UTF-8 kodiert.
400 invalid_request_error Ein Parameter auf /v1/shield/inspect oder /v1/shield/policy ist ungültig (etwa leerer oder über 256 KB großer input, mehr als 64 Einträge, unbekannte Regel oder ungültiger Sperrbegriff), oder der JSON-Body ist für die Shield-Extraktion zu tief verschachtelt.
400 provider_rejected_request Der Anbieter hat die Anfrage selbst abgelehnt, etwa wegen eines ungültigen Parameters oder eines zu langen Kontexts. Die Antwort trägt den Statuscode des Anbieters (400, 404, 409, 413, 422 oder einen anderen Statuscode 4xx außer 401, 402, 403 und 429), und message enthält die Meldung des Anbieters in gekürzter und bereinigter Form, höchstens 500 Zeichen. Auf Routen mit eigenem Anbieter-Schlüssel (BYOK) meldet das Gateway auch die Statuscodes 401, 402, 403 und 429 des Anbieters so, weil Schlüssel, Guthaben und Kontingent dem Kunden gehören; bei 429 kommt Retry-After hinzu.
400 invalid_request_tags Der Header X-Noirdoc-Tags oder der Tag-Name im Pfad unter /v1/tags ist leer, enthält mehr als 5 Tags oder entspricht nicht dem Format ^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,63}$.
401 invalid_api_key Der Schlüssel fehlt, ist ungültig oder deaktiviert, oder die Organisation ist nicht aktiv.
402 insufficient_credit Das Guthaben der Organisation ist aufgebraucht oder kleiner als die geschätzten Höchstkosten der Anfrage (einschließlich Noirdoc Shield, auch auf BYOK-Routen mit aktivem Shield).
402 key_budget_exhausted Das Budget dieses Schlüssels ist für den laufenden Zeitraum aufgebraucht oder reicht für die geschätzten Kosten der Anfrage nicht aus.
402 tag_budget_exhausted Das Budget eines in X-Noirdoc-Tags genannten Tags ist für den laufenden Zeitraum aufgebraucht oder reicht für die geschätzten Kosten der Anfrage nicht aus; message nennt das Tag.
403 reference_not_available_on_platform Der Body verweist auf Objekte beim Anbieter (etwa conversation, prompt.id oder vector_store_ids), deren Besitz das Gateway bei verwalteten Anbietern nicht prüfen kann.
403 model_not_allowed_for_key Das Modell gehört nicht zu den erlaubten Modellen dieses Schlüssels.
403 provider_not_allowed_for_tenant Die Organisation gilt als Berufsgeheimnisträger (§ 203 StGB); das schließt jeden Anbieter aus, der dieses Modell anbietet.
403 provider_not_allowed_for_key Die Einschränkungen des Schlüssels (Anbieter, Datenresidenz, CLOUD Act, § 203) schließen jeden Anbieter dieses Modells aus.
403 starter_model_not_allowed Die Organisation nutzt noch ausschließlich das Startguthaben, und das Modell bzw. sein verwalteter Anbieter ist im Startguthaben nicht freigegeben.
403 shield_violation Noirdoc Shield hat die Anfrage vor der Weiterleitung an den Anbieter blockiert, weil ein aktiver Schutzfilter mit der Aktion block angeschlagen hat; message nennt die ausgelöste Regel (secrets, pii, ner, injection oder custom).
403 file_content_not_allowed Die Anfrage enthält Dateien, Bilder oder Audio, und die Organisation lässt keine Dateiinhalte zu.
403 file_pii_blocked Eine Datei enthält personenbezogene Daten, und die klassische Dateianalyse der Organisation (Übergangsbetrieb bis 30.11.2026) steht auf block oder unter enforced auf detect_only.
403 model_not_billable Für das Modell ist kein vollständiger Preis hinterlegt, deshalb lässt es sich mit Guthaben nicht nutzen.
403 request_tags_disabled Die Anfrage sendet X-Noirdoc-Tags oder ruft /v1/tags auf, aber Request-Tags (Preview) sind für diese Organisation nicht freigeschaltet.
403 tag_not_found Das genannte Tag existiert nicht. Bei Anfragen mit X-Noirdoc-Tags ist die automatische Tag-Anlage ausgeschaltet (Statuscode 403); auf /v1/tags/{name} antwortet das Gateway mit Statuscode 404.
403 tag_disabled Ein in X-Noirdoc-Tags genanntes Tag ist deaktiviert.
403 tag_limit_exceeded Die Organisation hat die Obergrenze von 1.000 Request-Tags erreicht.
403 model_not_allowed_for_tag Das Modell gehört nicht zu den erlaubten Modellen eines in X-Noirdoc-Tags genannten Tags.
403 provider_not_allowed_for_tag Die Einschränkungen eines in X-Noirdoc-Tags genannten Tags (Anbieter, Datenresidenz, CLOUD Act, § 203) schließen jeden Anbieter dieses Modells aus.
404 object_not_found Das Objekt (Datei, Skill oder gespeicherte Antwort) existiert nicht oder gehört nicht deiner Organisation.
404 model_not_available Die Modell-ID ist für die Organisation nicht verfügbar.
413 request_too_large Der Body überschreitet das Größenlimit des Endpunkts.
413 shield_input_too_large Der zu prüfende Text der Anfrage überschreitet das Limit des Shield-Dienstes von 4 MiB kodiertem Text in einem Aufruf.
413 masking_input_too_large Ein einzelner Textabschnitt in einer Anfrage mit klassischer Maskierung (Übergangsbetrieb bis 30.11.2026) überschreitet das Zeichenlimit des Detektors.
422 shield_uninspectable_content Die Shield-Richtlinie steht auf enforced, und die Anfrage enthält Inhalte, die Shield nicht als Text prüfen kann (binary_document wie PDF oder Office, media_not_inspectable wie Bilder, Audio oder Video, file_reference per ID oder URL, file_too_large ab 4 MiB, file_not_decodable oder unrecognised_content). Das Gateway hat die Anfrage nicht weitergeleitet.
422 shield_config_invalid Die gespeicherte Shield-Konfiguration der Organisation ist ungültig (zum Beispiel enforced ohne aktiven Schutzfilter oder ein nicht kompilierbares Muster); das Gateway hat die Anfrage nicht weitergeleitet.
422 file_unprocessable Eine Datei ließ sich in der klassischen Dateianalyse (Übergangsbetrieb bis 30.11.2026) nicht verarbeiten: Die Datei ist zu groß, nicht lesbar oder hat ein Format ohne Analyse. Das Gateway hat die Anfrage nicht weitergeleitet.
429 starter_rate_limit_exceeded Die Organisation nutzt noch ausschließlich das Startguthaben und hat die Grenze von 5 Anfragen je Minute oder 25 Anfragen je Tag (UTC) für verwaltete Anbieter erreicht. Die Antwort enthält Retry-After mit der Wartezeit in Sekunden.
429 resource_exhausted Der Anbieter hat Kapazitätsprobleme oder ein erschöpftes Guthaben gemeldet (Statuscode 429 oder 402), auch nach Failover über bis zu drei Anbieter. Die Antwort enthält Retry-After mit der Wartezeit in Sekunden.
500 internal_error Im Gateway ist ein unerwarteter Fehler aufgetreten.
500 detection_error Die Erkennung personenbezogener Daten in der klassischen Maskierung (Übergangsbetrieb bis 30.11.2026) ist fehlgeschlagen; das Gateway hat die Anfrage nicht weitergeleitet.
502 provider_not_configured Für diese Anfrage ist in der Organisation kein passender Anbieter eingerichtet.
502 provider_misconfigured Die Konfiguration des gewählten Anbieters ist ungültig, zum Beispiel eine nicht erlaubte Basis-URL.
502 provider_unreachable Das Gateway konnte keine Verbindung zum Anbieter herstellen, oder die Verbindung ist abgebrochen.
502 provider_error Der Anbieter hat mit einem Fehler geantwortet (Statuscode 5xx außer 503 und 529, oder 401 und 403 auf Routen mit einem von Noirdoc verwalteten Anbieter), den die Anfrage nicht verursacht hat. Das Gateway ersetzt die Meldung des Anbieters durch einen festen Text. Auf Routen mit eigenem Anbieter-Schlüssel meldet es 401 und 403 als provider_rejected_request.
502 stream_interrupted Der Stream des Anbieters ist nach dem Beginn der Antwort abgebrochen oder hat einen Fehler gemeldet. Der Fehler steht im Stream selbst, weil der Statuscode 200 dann bereits gesendet ist. stream_interrupted trägt kein retry_after; nur Fehler im Stream, die einem HTTP-Fehler mit Wartezeit entsprechen, tragen es.
503 capacity_exhausted Alle Anbieter des Modells waren an ihrer Kapazitätsgrenze oder nach einem 429 pausiert, auch nach einer Wartezeit von bis zu 10 Sekunden. Die Antwort enthält Retry-After mit den Sekunden, bis voraussichtlich ein Anbieter wieder frei ist, höchstens 60, oder 5 Sekunden, wenn das nicht bekannt ist.
503 provider_overloaded Der Anbieter hat Überlast gemeldet (Statuscode 503 oder 529), auch nach Failover über bis zu drei Anbieter. Der Statuscode ist 503 bei OpenAI-Endpunkten und 529 bei /v1/messages und /v1/skills. Die Antwort enthält Retry-After mit dem Wert des Anbieters zwischen 1 und 60 Sekunden, sonst 5 Sekunden.
503 service_overloaded Das Gateway ist vorübergehend ausgelastet. Die Antwort enthält Retry-After mit 5 Sekunden.
503 forwarding_pool_exhausted Alle Verbindungen des Gateways zu den Anbietern sind belegt. Das ist eine Grenze des Gateways, nicht die eines Anbieters. Die Antwort enthält Retry-After mit 5 Sekunden.
503 provider_auth_unavailable Die Zugangsdaten des Gateways für den Anbieter sind gerade nicht verfügbar. Die Antwort enthält Retry-After mit 5 Sekunden.
503 ownership_check_unavailable Das Gateway konnte gerade nicht prüfen, ob das Objekt deiner Organisation gehört, und hat die Anfrage abgelehnt. Die Antwort enthält Retry-After mit 5 Sekunden.
503 shield_unavailable Der Noirdoc-Shield-Prüfdienst ist vorübergehend nicht erreichbar; das Gateway leitet eine zu prüfende Anfrage niemals ungeprüft weiter (Fail-closed). Die Antwort enthält Retry-After mit 5 Sekunden.
503 masking_unavailable Der Detektor der klassischen Maskierung (Übergangsbetrieb bis 30.11.2026) ist vorübergehend nicht erreichbar; das Gateway hat die Anfrage nicht weitergeleitet. Die Antwort enthält Retry-After mit 10 Sekunden.
503 gateway_restarting Das Gateway wurde neu gestartet (Deployment), während der Stream noch auf die Antwort des Anbieters wartete. Der Fehler steht im laufenden Stream, weil der Statuscode 200 dann bereits gesendet ist. Das Fehlerobjekt enthält retry_after mit 5 Sekunden.
504 provider_timeout Der Anbieter hat nicht innerhalb der Wartezeit des Gateways geantwortet. Die Antwort enthält Retry-After mit 10 Sekunden.