Zum Hauptinhalt springen
POST
Nachricht erstellen
Sende eine Payload der Anthropic Messages API an /v1/messages und erhalte eine Antwort im Anthropic-Format zurück, für jedes Modell, das Phaseo routet. Anthropic-Felder für Tool-Nutzung werden unterstützt, und der Header X-Phaseo-Strictness steuert, wie nicht unterstützte Parameter behandelt werden. Setze stream: true, um Server-Sent Events im Anthropic-Format zu erhalten (message_start, content_block_*, message_delta, message_stop). Streaming funktioniert auch in Tool-Schleifen.

Systemnachrichten mitten in der Unterhaltung

Füge messages eine Nachricht mit role: "system" hinzu, wenn eine Anweisung ab diesem Punkt der Unterhaltung gelten soll. Das Feld system auf oberster Ebene bleibt gleich, sodass ein gecachtes Präfix weiterhin trifft.
Eine Systemnachricht nimmt einen String oder Textblöcke. Sie muss direkt auf einen Benutzerzug folgen (oder auf einen Assistentenzug, der mit einem Server-Tool-Ergebnis endet) und entweder die letzte Nachricht sein oder von einem Assistentenzug gefolgt werden. Andere Positionen geben 400 zurück. clear_at, output_config sowie tool_addition- oder tool_removal-Blöcke werden nicht unterstützt.

Server-Tools verwenden

Füge tools ein phaseo:-Tool hinzu, und Phaseo führt es aus, wenn das Modell es aufruft. Upstream wird es in das Tool-Format von Anthropic umgeschrieben, und die Tool-Schleife läuft serverseitig weiter. /v1/messages akzeptiert jedes Server-Tool außer phaseo:apply_patch; der Leitfaden Server-Tools listet sie auf.
Server-Tool-Aufrufe werden in usage.server_tool_use gezählt. Der ältere Typ gateway:datetime funktioniert weiterhin. Mit stream: true führt Phaseo die Tool-Züge selbst aus und streamt dir dann die fortgesetzte Antwort als einen einzigen Stream.

Die native Websuche von Anthropic verwenden

Wenn das geroutete Anthropic-Modell und der Anbieter native Websuche unterstützen, übergib die Tool-Definition von Anthropic direkt, zum Beispiel type: "web_search_20250305". Das Anbieter-Routing filtert vor der Ausführung trotzdem nach Unterstützung für web_search_options.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json

Ein optionales Feld der obersten Ebene, das als null gesendet wird, gilt als nicht gesetzt, genau wie ein weggelassenes Feld.

model
string
erforderlich
messages
object[]
erforderlich
Minimum array length: 1
max_tokens
integer
erforderlich
Erforderlicher Bereich: x >= 1
models
string[]

Optionale, geordnete Fallback-Modelle, die nach model versucht werden. model ist erforderlich und immer das primäre Modell. Schlägt ein Versuch mit 429, 500, 502, 503 oder 504 fehl, wird der nächste Eintrag versucht; andere Fehler werden unverändert zurückgegeben. Akzeptiert bis zu 25 Modell-IDs oder Presets; Duplikate und Einträge, die model entsprechen, werden ignoriert. Jeder Versuch wird als eigene Anfrage validiert, protokolliert und abgerechnet, und das Feld model der Antwort sowie der Routing-Trace zeigen das Modell, das die Anfrage bedient hat. Streaming-Anfragen weichen nur vor dem ersten Byte aus, Video- und Musikjobs nur bei der Übermittlung. Batch-, Realtime- und Council-Anfragen lehnen models ab. Auf einer dynamischen Route festgelegte Fallbacks haben Vorrang, und phaseo/auto kann nicht mit models kombiniert werden.

Required array length: 1 - 25 elements
Minimum string length: 1
Beispiel:
prompt
object

Füllt die in einem Preset gespeicherte Prompt-Vorlage aus. Lassen Sie model weg oder setzen Sie dieselbe Referenz, und senden Sie eine leere Unterhaltung oder die Nachrichten, die nach der Vorlage folgen sollen.

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,
auto,
standard_only
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.

plugins
object[]

Gateway-Plugins für diese Anfrage. web ergänzt jedes Modell um Websuche und web-fetch um das Abrufen von Seiten; response-healing repariert fehlerhaftes JSON in nicht gestreamten strukturierten Antworten. Standardwerte aus Workspace und Preset werden mit dieser Liste zusammengeführt. Eine unbekannte Plugin-ID liefert 400 unknown_gateway_plugin.

Fügt der Anfrage das Server-Tool phaseo:web_search hinzu, sodass jedes Modell im Web suchen kann. Die Anfrage läuft, und Suchen werden gezählt und abgerechnet, genau wie mit einem phaseo:web_search-Tool. Enthält die Anfrage bereits ein Websuche-Tool, fügt das Plugin nichts hinzu. Andere Optionen werden ignoriert.

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
context_management
object

Kontextbearbeitung von Anthropic. edits akzeptiert die Strategien clear_tool_uses_* und clear_thinking_* und wird mit dem zugehörigen Beta-Header an Anthropic gesendet. Andere Anbieter führen die Anfrage ohne dieses Feld aus und nennen context_management in X-Phaseo-Dropped-Params. Bearbeitungen zur Komprimierung (compact_*) liefern 400.

user
string

Endbenutzerkennung, wie bei Chat Completions. Claude-Modelle erhalten sie als metadata.user_id, sofern metadata.user_id nicht gesetzt ist.

prompt_cache_key
string | null

Gruppiert zusammengehörige Anfragen, damit sie bei dem Anbieter bleiben, der ihren Prompt-Cache hat. Phaseo sendet einen Hash aus deinem Workspace und diesem Schlüssel an den Anbieter, nie den Rohschlüssel.

stop_sequences
string[]
cache_control
object

Prompt-Cache-Steuerung. Verwende type ephemeral mit einer optionalen ttl von 5m oder 1h. scope gilt nur für eine Claude-Cache-Richtlinie auf oberster Ebene. Amazon Bedrock und Google Vertex AI cachen Claude 3.7 Sonnet, 3.5 Sonnet und 3 Opus nur für 5 Minuten; dort wird die ttl entfernt, und eine entfernte 1h wird in X-Phaseo-Dropped-Params als cache_control.ttl gemeldet.

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
context_management
object

Vorhanden, wenn die Anfrage context_management verwendet und Anthropic eine Bearbeitung angewendet hat. applied_edits listet jede Bearbeitung mit den entfernten Inhalten auf. Bei Streams steht es im abschließenden message_delta-Ereignis.

Zuletzt geändert am 5. November 2026