Messages

curl https://api.noirdoc.de/v1/messages \
  -H "x-api-key: $NOIRDOC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<modell-id>",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Was schreibt Herr Müller der Kanzlei?"
      }
    ]
  }'

import os
import anthropic

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

message = client.messages.create(
    model="<modell-id>",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Was schreibt Herr Müller der Kanzlei?",
        }
    ],
)
print(message.content[0].text)

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

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

const message = await client.messages.create({
  model: "<modell-id>",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: "Was schreibt Herr Müller der Kanzlei?",
    },
  ],
});
console.log(message.content);

Die Modell-ID eines Claude-Modells finden Sie in GET /v1/models.

Was Noirdoc ändert

Unterrouten

count_tokens verlangt model und läuft wie /v1/messages über den Katalog. Ist die Maskierung aktiv, maskiert das Gateway die Anfrage auch hier. Der Anbieter zählt dann die Tokens der maskierten Anfrage. Claude Code nutzt diesen Endpunkt für genaue Token-Zahlen; ohne ihn schätzt Claude Code die Kontextgröße anhand der Zeichen.

Läuft das Modell bei Google Vertex, leitet das Gateway count_tokens an die Zählmethode count-tokens von Vertex weiter. Die Modell-ID überträgt es dafür in die Form, die Vertex erwartet. Lehnt Vertex die Anfrage ab, erhalten Sie den Statuscode und Body von Vertex unverändert.

count_tokens erzeugt keine Antwort des Modells. Das Gateway protokolliert den Aufruf, rechnet ihn aber nicht ab. Eine Kostenschätzung vor der Weiterleitung entfällt. Bei von Noirdoc verwalteten Anbietern gilt trotzdem: Ist das Guthaben der Organisation oder das Budget des Schlüssels aufgebraucht, antwortet das Gateway mit 402.

Andere Pfade unter /v1/messages/ beantwortet das Gateway mit 404 unsupported_endpoint.

Fehler auf diesem Endpunkt

Anthropic-Referenz

Alle übrigen Felder von Anfrage und Antwort beschreibt die API-Referenz von Anthropic für die Version 2023-06-01: Messages und Count tokens (geprüft am 30.09.2026).