Startseite / Dokumentation / Messages API

Messages API

POST /v1/messages — der Endpunkt im Anthropic-Format: Parameter, Antwortstruktur und Beispiele.

Als Markdown anzeigen ChatGPT fragen In Claude fragen

Der Endpunkt, den jeder Anthropic-kompatible Client verwendet, einschließlich Claude Code und der offiziellen SDKs.

EndpunktPOST https://aiprimetech.io/v1/messages

Authentifizierungx-api-key: sk-...

Versionsheaderanthropic-version: 2023-06-01

Inhaltstypapplication/json

Anfragekörper

Feld	Typ	Erforderlich	Beschreibung
`model`	Zeichenfolge	ja	Modell-ID, genau wie aufgeführt unter `/v1/models`
`messages`	Array	ja	Abwechselnde Nutzer- und Assistentenbeiträge, die ältesten zuerst
`max_tokens`	Ganzzahl	ja	Maximale Anzahl an Ausgabetokens. Hier endet die Generierung.
`system`	Zeichenfolge oder Array	nein	Systemprompt auf oberster Ebene. Keine Nachrichtenrolle.
`temperature`	Zahl	nein	0–1. Für den Modellstandard weglassen.
`top_p`	Zahl	nein	Nucleus-Sampling. Verwenden Sie entweder dies oder temperature, nicht beides.
`stop_sequences`	Array	nein	Zeichenfolgen, die bei ihrer Ausgabe die Generierung stoppen
`stream`	Boolescher Wert	nein	true für Server-Sent Events
`tools`	Array	nein	Tool-Definitionen — siehe Tool-Nutzung
`metadata`	Objekt	nein	Wird durchgereicht; `user_id` ist für Ihre eigene Zuordnung nützlich

Beispiel

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Antwort

{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}

Feld	Beschreibung
`content`	Array aus Blöcken. Textblöcke enthalten `type: text` und ein `text` Feld; Tool-Aufrufe enthalten `type: tool_use`.
`stop_reason`	`end_turn`, `max_tokens`, `stop_sequence` oder `tool_use`
`usage.input_tokens`	Abgerechnete Eingabe, einschließlich des vollständig erneut gesendeten Verlaufs
`usage.output_tokens`	Abgerechnete Ausgabe — in der Regel das 4–5-Fache des Eingabepreises

Systemprompts

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}

Ein unveränderlicher system Block eignet sich ideal für Prompt-Caching — er ist bei jedem Aufruf identisch und kann daher zu einem Bruchteil des Eingabepreises aus dem Cache gelesen werden.

Multimodale Eingabe

Bildblöcke verwenden die standardmäßige Anthropic-Struktur — siehe Bildverarbeitung.

StreamingTokenweise Ausgabe Tool-NutzungFunktionsaufrufe FehlerFehlerszenarien