Skip to main content
POST
Crear una respuesta

Herramientas del servidor

/v1/responses admite herramientas de funciones habituales y estas herramientas de servidor administradas por Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
  • phaseo:apply_patch

Ejemplo de fecha y hora

Cuando se usa una herramienta del servidor, los datos de uso incluyen los contadores correspondientes de usage.server_tool_use.*.
  • gateway:datetime -> datetime_requests
  • phaseo:web_search -> web_search_requests, web_search_results, web_search_extra_results
  • phaseo:web_fetch -> web_fetch_requests
  • phaseo:advisor -> advisor_requests
  • phaseo:image_generation -> image_generation_requests
  • phaseo:apply_patch -> apply_patch_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
input
requerido
background
boolean
include
string[]
instructions
string
max_output_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
parallel_tool_calls
boolean
previous_response_id
string
reasoning
object
service_tier
enum<string>
Opciones disponibles:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
store
boolean
stream
boolean
temperature
number
Rango requerido: 0 <= x <= 2
text
object
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
tools
object[]

Definiciones de herramientas para llamadas a funciones del modelo y herramientas de servidor del gateway. Las herramientas de servidor integradas del gateway son gateway:datetime, gateway:web_search y gateway:web_fetch.

top_p
number
Rango requerido: 0 <= x <= 1
truncation
enum<string>
Opciones disponibles:
auto,
disabled
user
string
prompt_cache_key
string | null
safety_identifier
string | null
modalities
enum<string>[]
Opciones disponibles:
text,
image,
audio
image_config
object
provider_options
object

Opciones específicas del proveedor, si se necesitan.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

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

provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

Respuesta

Respuesta

id
string
object
string
created
integer
model
string
provider
string
provider_id
string
nativeResponseId
string | null
status
enum<string>
Opciones 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
Última modificación el 2 de octubre de 2026