Passer au contenu principal
POST
Créer une complétion de chat

Utiliser les outils serveur

Ajoutez un outil phaseo: dans tools à côté de vos propres outils de fonction : Phaseo l’exécute lorsque le modèle l’appelle. /v1/chat/completions accepte tous les outils serveur sauf phaseo:apply_patch ; le guide Outils serveur les liste.
Chaque appel d’outil serveur est compté dans usage.server_tool_use :
phaseo:web_search ajoute web_search_requests, web_search_results et web_search_extra_results ; phaseo:web_fetch ajoute web_fetch_requests. 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.

Raisonnement dans les boucles d’outils

Les modèles de raisonnement renvoient leur raisonnement dans deux champs du message de l’assistant :
  • reasoning_content : le texte du raisonnement, lorsque le fournisseur en renvoie un.
  • reasoning_details : un tableau de blocs de raisonnement. Chaque entrée possède un type (reasoning.text, reasoning.summary ou reasoning.encrypted), un index et un format qui indique la famille du fournisseur, par exemple anthropic-claude-v1 ou google-gemini-v1.
Les entrées peuvent contenir un état du fournisseur dont le modèle a besoin à l’étape suivante d’une boucle d’outils : En streaming, un delta reasoning_details arrive dès qu’un bloc de raisonnement est terminé.
Renvoyez chaque message de l’assistant avec son reasoning_details inchangé, dans chaque requête, et pas seulement dans les boucles d’outils. N’abandonnez, ne modifiez et ne réordonnez jamais les entrées, chiffrées ou non, y compris celles sans texte.
Les valeurs de signature et de data sont opaques et enregistrent le fournisseur et le modèle qui les ont produites. Phaseo ne les envoie qu’à cette famille de fournisseurs et à ce modèle : un fallback vers un autre fournisseur les abandonne au lieu d’échouer. Sans elles, les modèles Claude en mode de thinking manuel exécutent l’étape suivante de la boucle d’outils sans thinking, et un changement de reasoning_effort redémarre le cache de prompts de Claude ; consultez Changer l’effort de raisonnement en cours de conversation.

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
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.

reasoning
object
reasoning_effort
enum<string>

Alias compatible avec OpenAI pour reasoning.effort.

Options disponibles:
none,
instant,
minimal,
low,
medium,
high,
xhigh,
max
frequency_penalty
number
Plage requise: -2 <= x <= 2
logit_bias
object
max_completion_tokens
integer
Plage requise: x >= 1
max_tokens
integer
Plage requise: x >= 1
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
presence_penalty
number
Plage requise: -2 <= x <= 2
seed
integer
Plage requise: -9223372036854776000 <= x <= 9223372036854776000
store
boolean
stream
boolean
défaut:false
stream_options
object
temperature
number
défaut:1
Plage requise: 0 <= x <= 2
tools
object[]

Définitions des outils pour les appels de fonctions du modèle et les outils serveur de la passerelle. Les outils intégrés incluent date et heure, recherche Web, récupération de pages Web, Advisor, Subagent, Fusion, recherche de modèles, génération d’images et création de patchs.

max_tool_calls
integer
Plage requise: x >= 1
parallel_tool_calls
boolean
défaut:true
tool_choice

Stratégie de sélection des outils. Les types d’outils serveur Phaseo sont acceptés et convertis en cibles de fonctions ou d’outils du fournisseur amont. Un objet allowed_tools est transmis tel quel à OpenAI, avec tous les outils. Les autres fournisseurs ne reçoivent que les outils autorisés et son mode (auto ou required), ou un appel forcé lorsque required n’autorise qu’un seul outil. Si allowed_tools liste un outil que tools ne définit pas, seul OpenAI peut traiter la requête ; sinon, une erreur 400 est renvoyée.

Options disponibles:
auto,
none,
required,
phaseo:datetime,
phaseo:web_search,
phaseo:web_fetch,
phaseo:subagent,
phaseo:fusion,
phaseo:search_models,
gateway:datetime,
gateway:web_search,
gateway:web_fetch
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.

logprobs
boolean
défaut:false
top_logprobs
integer
Plage requise: 0 <= x <= 20
top_p
number
Plage requise: 0 <= x <= 1
stop
response_format
modalities
enum<string>[]
Options disponibles:
text,
image,
audio
image_config
object
usage
boolean
provider

Sélecteur de fournisseur. Utilisez une chaîne pour un seul fournisseur ou des options de routage comme { "only": ["groq"] }.

Options disponibles:
openai,
anthropic,
google-ai-studio,
gemini,
mistral,
x-ai,
xai,
groq,
together
provider_options
object

Options propres au fournisseur, facultatives.

user_id
string
user
string
include_reasoning
boolean

Accepté pour des raisons de compatibilité. Le raisonnement est renvoyé chaque fois que le modèle en produit (reasoning_content et reasoning_details), quelle que soit la valeur de ce champ.

prediction
object

Sortie prédite, pour des réponses plus rapides lorsque l’essentiel de la réponse est connu à l’avance. Transmise aux modèles OpenAI, Mistral et Moonshot ; les autres fournisseurs l’ignorent.

service_tier
enum<string> | null

Sélectionne un niveau de routage ou de tarification pris en charge. auto (ou null) ne demande aucun niveau particulier : la requête est routée et facturée comme si le champ n’était pas défini ; scale est traité comme default, le niveau standard.

Options disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch,
auto,
scale
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.

prompt_cache_retention
enum<string>

Conservation du cache de prompts pour les modèles OpenAI et Azure OpenAI antérieurs à GPT-5.6. Prévaut sur provider_options.openai.prompt_cache_retention.

Options disponibles:
in_memory,
24h
prompt_cache_options
object

Mode et TTL du cache de prompts pour OpenAI et Azure OpenAI à partir de GPT-5.6 (ttl 30m, ou 12h chez OpenAI) et pour DeepInfra (ttl 5m ou 1h). Retiré pour les autres fournisseurs.

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.

safety_identifier
string | null
meta
boolean
défaut:false
echo_upstream_request
boolean
debug
object

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

Réponse

Réponse de complétion de chat

id
string
nativeResponseId
string | null
object
string
created
integer
model
string
provider
string
choices
object[]
usage
object
Dernière modification le 12 novembre 2026