Skip to main content
POST
Crear una finalización de chat

Herramientas del servidor

/v1/chat/completions admite herramientas de funciones normales y estas herramientas de servidor administradas por Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation

Ejemplo de fecha y hora

Cuando se usa una herramienta del servidor, los datos de uso incluyen:
phaseo:web_search agrega server_tool_use.web_search_requests, server_tool_use.web_search_results y server_tool_use.web_search_extra_results. phaseo:web_fetch agrega server_tool_use.web_fetch_requests.

Nota sobre el streaming

También se admite stream: true. Para las herramientas de servidor administradas por Gateway, Phaseo puede materializar el turno de llamada a la herramienta upstream, continuar el ciclo y volver a emitir un flujo sintético.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
requerido
messages
object[]
requerido
Minimum array length: 1
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.

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
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
service_tier
enum<string>
Opciones disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
prompt_cache_key
string | null
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 2 de octubre de 2026