Saltar al contenido principal
POST
Crear una finalización de chat

Usa herramientas del servidor

Añade una herramienta phaseo: a tools junto a tus propias herramientas de función, y Phaseo la ejecuta cuando el modelo la llama. /v1/chat/completions acepta todas las herramientas del servidor excepto phaseo:apply_patch; la guía de Herramientas del servidor las enumera.
Cada llamada a una herramienta del servidor se cuenta en usage.server_tool_use:
phaseo:web_search añade web_search_requests, web_search_results y web_search_extra_results; phaseo:web_fetch añade web_fetch_requests. El tipo antiguo gateway:datetime sigue funcionando. Con stream: true, Phaseo ejecuta los turnos de herramientas por su cuenta y después te transmite la respuesta continuada como un único stream.

Razonamiento en bucles de herramientas

Los modelos de razonamiento devuelven su razonamiento en el mensaje del asistente, en dos campos:
  • reasoning_content: el texto del razonamiento, cuando el proveedor lo devuelve.
  • reasoning_details: un array de bloques de razonamiento. Cada entrada tiene un type (reasoning.text, reasoning.summary o reasoning.encrypted), un index y un format que nombra la familia del proveedor, por ejemplo anthropic-claude-v1 o google-gemini-v1.
Las entradas pueden llevar estado del proveedor que el modelo necesita en el siguiente paso de un bucle de herramientas: Con streaming, llega un delta reasoning_details cuando se completa cada bloque de razonamiento.
Devuelve cada mensaje del asistente con su reasoning_details sin cambios, en cada solicitud, no solo en los bucles de herramientas. Nunca descartes, edites ni reordenes entradas, cifradas o no, incluidas las entradas sin texto.
Los valores de signature y data son opacos y registran el proveedor y el modelo que los generaron. Phaseo solo los envía a esa familia de proveedor y a ese modelo, así que un fallback a otro proveedor los descarta en lugar de fallar. Sin ellos, los modelos de Claude en modo de pensamiento manual ejecutan el siguiente paso del bucle de herramientas sin pensamiento, y un cambio de reasoning_effort reinicia la caché de prompts de Claude; consulta Cambia el esfuerzo de razonamiento a mitad de la conversación.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json

Un campo opcional de nivel superior enviado como null se trata como no definido, igual que si se omitiera.

model
string
requerido
messages
object[]
requerido
Minimum array length: 1
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

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

Rellena la plantilla de prompt guardada en un preset. Omite model o usa la misma referencia, y envía una conversación vacía o los turnos que se añadirán después de la plantilla.

reasoning
object
reasoning_effort
enum<string>

Alias compatible con OpenAI para reasoning.effort.

Opciones disponibles:
none,
instant,
minimal,
low,
medium,
high,
xhigh,
max
frequency_penalty
number
Rango requerido: -2 <= x <= 2
logit_bias
object
max_completion_tokens
integer
Rango requerido: x >= 1
max_tokens
integer
Rango requerido: x >= 1
metadata
object
session_id
string

Identificador único para agrupar solicitudes relacionadas (por ejemplo, una conversación o un flujo de trabajo de agente) y facilitar la observabilidad.

Maximum string length: 256
presence_penalty
number
Rango requerido: -2 <= x <= 2
seed
integer
Rango requerido: -9223372036854776000 <= x <= 9223372036854776000
store
boolean
stream
boolean
predeterminado:false
stream_options
object
temperature
number
predeterminado:1
Rango requerido: 0 <= x <= 2
tools
object[]

Definiciones de herramientas para llamadas a funciones del modelo y herramientas de servidor del gateway. Las herramientas integradas incluyen fecha y hora, búsqueda web, obtención de páginas web, Advisor, Subagent, Fusion, búsqueda de modelos, generación de imágenes y creación de parches.

max_tool_calls
integer
Rango requerido: x >= 1
parallel_tool_calls
boolean
predeterminado:true
tool_choice

Estrategia de selección de herramientas. Se aceptan los tipos de herramientas de servidor de Phaseo y se transforman en destinos de funciones o herramientas del proveedor de origen. Un objeto allowed_tools se envía tal cual a OpenAI, junto con todas las herramientas. Los demás proveedores reciben solo las herramientas permitidas y su modo (auto o required), o una llamada forzada cuando required permite exactamente una herramienta. Si allowed_tools incluye una herramienta que tools no define, solo OpenAI puede atender la solicitud; de lo contrario, se devuelve un error 400.

Opciones 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 del gateway para esta solicitud. web añade búsqueda web y web-fetch añade la lectura de páginas a cualquier modelo; response-healing repara el JSON mal formado en las respuestas estructuradas no transmitidas en streaming. Los valores predeterminados del espacio de trabajo y del preset se combinan con esta lista. Un id de plugin desconocido devuelve 400 unknown_gateway_plugin.

Añade a la solicitud la herramienta de servidor phaseo:web_search, para que cualquier modelo pueda buscar en la web. La solicitud se ejecuta, y las búsquedas se cuentan y facturan, exactamente igual que con una herramienta phaseo:web_search. Si la solicitud ya tiene una herramienta de búsqueda web, el plugin no añade nada. Las demás opciones se ignoran.

logprobs
boolean
predeterminado:false
top_logprobs
integer
Rango requerido: 0 <= x <= 20
top_p
number
Rango requerido: 0 <= x <= 1
stop
response_format
modalities
enum<string>[]
Opciones disponibles:
text,
image,
audio
image_config
object
usage
boolean
provider

Selector del proveedor. Usa una cadena para indicar un solo proveedor u opciones de enrutamiento como { "only": ["groq"] }.

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

Opciones específicas del proveedor, si se necesitan.

user_id
string
user
string
include_reasoning
boolean

Se acepta por compatibilidad. El razonamiento se devuelve siempre que el modelo lo genera (reasoning_content y reasoning_details), sea cual sea el valor de este campo.

prediction
object

Salida prevista, para obtener respuestas más rápidas cuando se conoce de antemano la mayor parte de la respuesta. Se reenvía a los modelos de OpenAI, Mistral y Moonshot; los demás proveedores la ignoran.

service_tier
enum<string> | null

Selecciona un nivel de enrutamiento o precios compatible. auto (o null) no pide ningún nivel concreto y se enruta y factura como si el campo no estuviera definido; scale se trata como default, el nivel estándar.

Opciones disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch,
auto,
scale
prompt_cache_key
string | null

Agrupa las solicitudes relacionadas para que se mantengan en el proveedor que tiene su caché de prompts. Phaseo envía al proveedor un hash de tu espacio de trabajo y esta clave, nunca la clave sin procesar.

prompt_cache_retention
enum<string>

Retención de la caché de prompts para los modelos de OpenAI y Azure OpenAI anteriores a GPT-5.6. Prevalece sobre provider_options.openai.prompt_cache_retention.

Opciones disponibles:
in_memory,
24h
prompt_cache_options
object

Modo y TTL de la caché de prompts para OpenAI y Azure OpenAI desde GPT-5.6 (ttl 30m, o 12h en OpenAI) y para DeepInfra (ttl 5m o 1h). Se elimina para los demás proveedores.

cache_control
object

Control de la caché de prompts. Usa type ephemeral con un ttl opcional de 5m o 1h. scope solo se aplica a una política de caché de Claude de nivel superior. Amazon Bedrock y Google Vertex AI almacenan en caché Claude 3.7 Sonnet, 3.5 Sonnet y 3 Opus solo durante 5 minutos; allí se elimina el ttl y un 1h eliminado se informa en X-Phaseo-Dropped-Params como cache_control.ttl.

safety_identifier
string | null
meta
boolean
predeterminado:false
echo_upstream_request
boolean
debug
object

Controles de depuración de la pasarela. Estas opciones nunca se reenvían al proveedor.

Respuesta

Respuesta de finalización de chat

id
string
nativeResponseId
string | null
object
string
created
integer
model
string
provider
string
choices
object[]
usage
object
Última modificación el 12 de noviembre de 2026