Skip to main content
POST
Créer un message
/v1/messages accepte les corps de requête de l’API Anthropic Messages et renvoie des réponses au format Anthropic.

Diffusion en continu

Définissez stream: true pour recevoir des événements envoyés par le serveur au format Anthropic (message_start, content_block_*, message_delta, message_stop).

Remarques

  • Les champs Anthropic d’utilisation des outils sont pris en charge.
  • stream: true fonctionne aussi avec les boucles d’outils. Pour les outils serveur gérés par le Gateway, Phaseo peut matérialiser le tour amont, poursuivre la boucle et réémettre un flux synthétique.
  • Le format natif de l’outil de recherche Web Anthropic est également accepté directement dans tools, par exemple type: "web_search_20250305".
  • L’en-tête X-Phaseo-Strictness contrôle le traitement des paramètres non pris en charge.

Outils serveur

/v1/messages prend également en charge les outils serveur gérés par le Gateway suivants :
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
Phaseo convertit ces outils au format compatible avec Anthropic pour le fournisseur amont, les exécute côté serveur et poursuit la boucle d’outils.

Recherche Web native du fournisseur

Lorsqu’un couple modèle/fournisseur Anthropic compatible prend en charge la recherche Web native, vous pouvez transmettre directement sa définition d’outil :
Le routage du fournisseur vérifie toujours la prise en charge de web_search_options avant l’exécution.

Exemple de date et heure

Le cas échéant, les compteurs usage.server_tool_use.* indiquent les appels des outils serveur.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json
model
string
requis
messages
object[]
requis
Minimum array length: 1
max_tokens
integer
requis
Plage requise: x >= 1
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
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.

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
stop_sequences
string[]
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
Dernière modification le 2 octobre 2026