Skip to main content
POST
Nachricht erstellen
/v1/messages akzeptiert Request-Payloads der Anthropic Messages API und gibt Antworten im Anthropic-Format zurück.

Datenstrom

Setze stream: true, um Server-Sent Events im Anthropic-Format (message_start, content_block_*, message_delta, message_stop) zu erhalten.

Hinweise

  • Anthropic-Felder zur Tool-Nutzung werden unterstützt.
  • stream: true funktioniert auch mit Tool-Schleifen. Bei vom Gateway verwalteten Servertools kann Phaseo den Upstream-Zug materialisieren, die Schleife fortsetzen und einen synthetischen Stream erneut ausgeben.
  • Das native Format des Anthropic-Websuche-Tools wird auch direkt in tools akzeptiert, zum Beispiel type: "web_search_20250305".
  • Der Header X-Phaseo-Strictness steuert den Umgang mit nicht unterstützten Parametern.

Servertools

/v1/messages unterstützt außerdem diese vom Gateway verwalteten Servertools:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
Phaseo wandelt diese Tools für den Upstream-Anbieter in ein Anthropic-kompatibles Format um, führt sie serverseitig aus und setzt die Tool-Schleife fort.

Native Websuche des Anbieters

Wenn ein kompatibles Anthropic-Modell-/Anbieter-Paar native Websuche unterstützt, kannst du die native Tool-Definition direkt übergeben:
Das Provider-Routing prüft vor der Ausführung weiterhin die Unterstützung von web_search_options.

Beispiel für Datum und Uhrzeit

Bei Verwendung geben die usage.server_tool_use.*-Zähler die Aufrufe der Servertools an.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
messages
object[]
erforderlich
Minimum array length: 1
max_tokens
integer
erforderlich
Erforderlicher Bereich: x >= 1
system
service_tier
enum<string>

Wählt eine unterstützte Routing- oder Preisstufe auf kompatiblen Text-APIs.

Verfügbare Optionen:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
temperature
number
Erforderlicher Bereich: 0 <= x <= 1
top_p
number
Erforderlicher Bereich: 0 <= x <= 1
top_k
integer
Erforderlicher Bereich: x >= 1
tools
object[]

Anthropic-kompatible Tools und vom Gateway verwaltete Servertools.

tool_choice

Anthropic-Toolauswahl als Objekt oder Zeichenfolge. Namen von Gateway-verwalteten Servertools werden ebenfalls akzeptiert und vom Gateway umgeschrieben.

stream
boolean
metadata
object
session_id
string

Eindeutige Kennung, um zusammengehörige Anfragen (zum Beispiel eine Unterhaltung oder einen Agenten-Workflow) für die Beobachtbarkeit zu gruppieren.

Maximum string length: 256
reasoning
object
stop_sequences
string[]
provider_options
object

Optionale anbieterspezifische Optionen.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

Gateway-Debug-Steuerungen. Diese Flags werden niemals an den Anbieter weitergeleitet.

provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

Antwort

Nachrichtenantwort

id
string
type
string
role
enum<string>
Verfügbare Optionen:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
Zuletzt geändert am 2. Oktober 2026