Source: https://aiprimetech.io/de/docs/api-reference/messages/

[Startseite](/de/) / [Dokumentation](/de/docs/) / Messages API 

# Messages API 

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

 Seite kopieren [ Als Markdown anzeigen](/de/docs/api-reference/messages.md) [ ChatGPT fragen](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ In Claude fragen](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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](/de/docs/api-reference/tool-use/)

 | metadata | Objekt | nein | Wird durchgereicht; user_id ist für Ihre eigene Zuordnung nützlich 

## Beispiel 

```
Copycurl 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 

```
Copy{
  "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 

```
Copy{
  "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](/de/docs/guides/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](/de/docs/api-reference/vision/). 

[StreamingTokenweise Ausgabe](/de/docs/api-reference/streaming/)[Tool-NutzungFunktionsaufrufe](/de/docs/api-reference/tool-use/)[FehlerFehlerszenarien](/de/docs/api-reference/errors/) 

[ZurückAPI-Überblick](/de/docs/api-reference/overview/)[WeiterChat Completions API](/de/docs/api-reference/chat-completions/)