Passer au contenu principal
POST
Créer un message
Envoyez une charge utile de l’API Anthropic Messages à /v1/messages et recevez une réponse au format Anthropic, pour n’importe quel modèle routé par Phaseo. Les champs d’utilisation d’outils d’Anthropic sont pris en charge, et l’en-tête X-Phaseo-Strictness détermine le traitement des paramètres non pris en charge. Définissez stream: true pour recevoir des server-sent events au format Anthropic (message_start, content_block_*, message_delta, message_stop). Le streaming fonctionne aussi dans les boucles d’outils.

Messages système en cours de conversation

Ajoutez un message role: "system" dans messages pour une instruction qui s’applique à partir de ce point de la conversation. Le champ system de niveau supérieur ne change pas, donc un préfixe mis en cache est toujours réutilisé.
Un message système accepte une chaîne ou des blocs de texte. Il doit suivre directement un tour utilisateur (ou un tour assistant qui se termine par un résultat d’outil serveur) et être le dernier message ou être suivi d’un tour assistant. Toute autre position renvoie un 400. clear_at, output_config et les blocs tool_addition ou tool_removal ne sont pas pris en charge.

Utiliser les outils serveur

Ajoutez un outil phaseo: dans tools : Phaseo l’exécute lorsque le modèle l’appelle, le réécrit au format d’outil d’Anthropic pour le fournisseur et poursuit la boucle d’outils côté serveur. /v1/messages accepte tous les outils serveur sauf phaseo:apply_patch ; le guide Outils serveur les liste.
Les appels d’outils serveur sont comptés dans usage.server_tool_use. L’ancien type gateway:datetime fonctionne toujours. Avec stream: true, Phaseo exécute lui-même les tours d’outils, puis vous transmet la suite de la réponse en un seul flux.

Utiliser la recherche web native d’Anthropic

Lorsque le modèle et le fournisseur Anthropic routés prennent en charge la recherche web native, transmettez directement la définition d’outil d’Anthropic, par exemple type: "web_search_20250305". Le routage des fournisseurs filtre toujours sur la prise en charge de web_search_options avant l’exécution.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json

Un champ facultatif de premier niveau envoyé avec la valeur null est traité comme non défini, comme s’il était omis.

model
string
requis
messages
object[]
requis
Minimum array length: 1
max_tokens
integer
requis
Plage requise: x >= 1
models
string[]

Modèles de repli facultatifs et ordonnés, essayés après model. model est obligatoire et reste toujours le modèle principal. Lorsqu'une tentative échoue avec 429, 500, 502, 503 ou 504, l'entrée suivante est essayée ; les autres erreurs sont renvoyées telles quelles. Accepte jusqu'à 25 identifiants de modèle ou préréglages ; les doublons et les entrées identiques à model sont ignorés. Chaque tentative est validée, journalisée et facturée comme une requête distincte, et le champ model de la réponse ainsi que la trace de routage indiquent le modèle qui a servi la requête. Les requêtes en streaming ne basculent qu'avant le premier octet, et les tâches vidéo et musique uniquement lors de leur soumission. Les requêtes batch, realtime et council rejettent models. Les replis définis sur une route dynamique sont prioritaires, et phaseo/auto ne peut pas être combiné avec models.

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

Remplit le modèle de prompt enregistré sur un preset. Omettez model ou indiquez la même référence, et envoyez une conversation vide ou les tours à ajouter après le modèle.

system
service_tier
enum<string>

Sélectionne un niveau de routage ou de tarification pris en charge sur les API de texte compatibles.

Options disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch,
auto,
standard_only
temperature
number
Plage requise: 0 <= x <= 1
top_p
number
Plage requise: 0 <= x <= 1
top_k
integer
Plage requise: x >= 1
tools
object[]

Outils compatibles avec Anthropic, ainsi que des outils serveur gérés par la passerelle.

tool_choice

Objet ou chaîne de choix d’outil Anthropic. Les noms des outils serveur gérés par la passerelle sont également acceptés et réécrits par celle-ci.

plugins
object[]

Plugins de la passerelle pour cette requête. web ajoute la recherche web et web-fetch la lecture de pages à n'importe quel modèle ; response-healing répare le JSON mal formé des réponses structurées non diffusées en streaming. Les valeurs par défaut de l'espace de travail et du préréglage sont fusionnées avec cette liste. Un identifiant de plugin inconnu renvoie 400 unknown_gateway_plugin.

Ajoute l'outil serveur phaseo:web_search à la requête, pour que n'importe quel modèle puisse chercher sur le web. La requête s'exécute, et les recherches sont comptées et facturées, exactement comme avec un outil phaseo:web_search. Si la requête contient déjà un outil de recherche web, le plugin n'ajoute rien. Les autres options sont ignorées.

stream
boolean
metadata
object
session_id
string

Identifiant unique permettant de regrouper des requêtes liées (par exemple, une conversation ou un flux de travail d’agent) à des fins d’observabilité.

Maximum string length: 256
reasoning
object
context_management
object

Édition du contexte d’Anthropic. edits accepte les stratégies clear_tool_uses_* et clear_thinking_* et est envoyé à Anthropic avec son en-tête bêta. Les autres fournisseurs exécutent la requête sans ce champ et indiquent context_management dans X-Phaseo-Dropped-Params. Les modifications de compactage (compact_*) renvoient 400.

user
string

Identifiant de l’utilisateur final, comme dans Chat Completions. Les modèles Claude le reçoivent sous la forme metadata.user_id, sauf si metadata.user_id est défini.

prompt_cache_key
string | null

Regroupe les requêtes liées afin qu’elles restent chez le fournisseur qui détient leur cache de prompts. Phaseo envoie au fournisseur un hachage de votre espace de travail et de cette clé, jamais la clé brute.

stop_sequences
string[]
cache_control
object

Contrôle du cache de prompts. Utilisez type ephemeral avec un ttl facultatif de 5m ou 1h. scope ne s’applique qu’à une politique de cache Claude de premier niveau. Amazon Bedrock et Google Vertex AI ne mettent en cache Claude 3.7 Sonnet, 3.5 Sonnet et 3 Opus que pendant 5 minutes ; le ttl y est retiré, et un 1h retiré est signalé dans X-Phaseo-Dropped-Params sous la forme cache_control.ttl.

provider_options
object

Options propres au fournisseur, facultatives.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

Options de débogage de la passerelle. Ces indicateurs ne sont jamais transmis au fournisseur.

provider
object

Préférences de routage des fournisseurs pour la sélection par la passerelle.

Réponse

Réponse du message

id
string
type
string
role
enum<string>
Options disponibles:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
context_management
object

Présent lorsque la requête utilisait context_management et qu’Anthropic a appliqué une modification. applied_edits liste chaque modification avec ce qu’elle a effacé. En streaming, il figure dans l’événement message_delta final.

Dernière modification le 5 novembre 2026