Passer au contenu principal
POST
Créer une réponse

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/responses accepte tous les outils serveur, y compris phaseo:apply_patch, que seul cet endpoint prend en charge ; le guide Outils serveur les liste.
Chaque appel d’outil serveur est compté 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.

Raisonnement dans les boucles d’outils

Avec OpenAI, Azure OpenAI et xAI, Phaseo envoie les requêtes Responses au fournisseur avec store: false : le raisonnement d’un modèle ne se poursuit donc d’une étape à l’autre d’une boucle d’outils qu’au moyen des éléments de sortie reasoning. Chaque élément reasoning possède un id, un summary et un content. Lorsque le fournisseur renvoie un état de raisonnement, l’élément contient aussi encrypted_content, qui contient l’un des éléments suivants :
  • Le raisonnement chiffré d’OpenAI, d’Azure OpenAI et de xAI. Phaseo le demande avec include: ["reasoning.encrypted_content"] pour les modèles de raisonnement.
  • Les signatures de thinking de Claude et le thinking masqué.
  • Les signatures de pensée de Gemini, y compris un élément reasoning distinct placé juste avant l’appel de fonction auquel une signature appartient.
  • Le niveau d’effort auquel une réponse de Claude s’est exécutée, dans le dernier élément reasoning de la sortie, qui n’a pas de texte.
Les réponses en streaming contiennent les mêmes éléments dans response.output_item.done et response.completed.
Renvoyez tous les éléments de sortie dans input sans les modifier dans chaque requête, et pas seulement dans les boucles d’outils. N’abandonnez, ne modifiez et ne réordonnez jamais les éléments reasoning, avec ou sans encrypted_content, y compris ceux sans texte.
encrypted_content est opaque et enregistre le fournisseur et le modèle qui l’ont produit. Phaseo ne l’envoie qu’à cette famille de fournisseurs et à ce modèle : un fallback vers un autre fournisseur l’abandonne au lieu d’échouer. Sans lui, Claude perd son raisonnement entre les étapes de la boucle d’outils, 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
input
requis
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.

background
boolean
include
string[]
instructions
string
max_output_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
parallel_tool_calls
boolean
previous_response_id
string

Non pris en charge. Phaseo ne stocke pas les réponses : les requêtes qui définissent previous_response_id ou conversation renvoient 400 unsupported_param. Envoyez toute la conversation dans input.

reasoning
object
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
store
boolean
stream
boolean
temperature
number
Plage requise: 0 <= x <= 2
text
object
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.

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
tools
object[]

Définitions des outils pour les appels de fonctions du modèle et les outils serveur de la passerelle. Les outils serveur intégrés de la passerelle sont gateway:datetime, gateway:web_search et gateway:web_fetch.

top_p
number
Plage requise: 0 <= x <= 1
truncation
enum<string>
Options disponibles:
auto,
disabled
user
string
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
modalities
enum<string>[]
Options disponibles:
text,
image,
audio
image_config
object
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

id
string
object
string
created
integer
model
string
provider
string
provider_id
string
nativeResponseId
string | null
status
enum<string>
Options disponibles:
completed,
failed,
incomplete
finish_reason
string | null
meta
object
cost_nanos
number
cost_cents
integer
currency
string
pricing_lines
object[]
output
object[]
output_items
object[]
content
object[]
role
string
stop_reason
string
type
string
usage
object
Dernière modification le 12 novembre 2026