Skip to main content
POST
Criar uma resposta

Ferramentas do servidor

/v1/responses aceita ferramentas de função comuns e estas ferramentas de servidor gerenciadas pelo Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
  • phaseo:apply_patch

Exemplo de data e hora

Quando uma ferramenta de servidor é usada, o uso inclui os contadores correspondentes 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 streaming

stream: true também é compatível. Para ferramentas de servidor gerenciadas pelo Gateway, a Phaseo pode materializar o turno de chamada à ferramenta upstream, continuar o ciclo e emitir novamente um stream sintético.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
input
obrigatório
background
boolean
include
string[]
instructions
string
max_output_tokens
integer
Intervalo obrigatório: x >= 1
metadata
object
session_id
string

Identificador exclusivo para agrupar solicitações relacionadas (por exemplo, uma conversa ou um fluxo de trabalho de agente) para observabilidade.

Maximum string length: 256
parallel_tool_calls
boolean
previous_response_id
string
reasoning
object
service_tier
enum<string>
Opções disponíveis:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
store
boolean
stream
boolean
temperature
number
Intervalo obrigatório: 0 <= x <= 2
text
object
tool_choice

Estratégia de seleção de ferramentas. Os tipos de ferramentas de servidor do Phaseo são aceitos e convertidos em destinos de função ou ferramenta do provedor upstream.

Opções disponíveis:
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[]

Definições de ferramentas para chamadas de função do modelo e ferramentas de servidor do gateway. As ferramentas de servidor integradas do gateway são gateway:datetime, gateway:web_search e gateway:web_fetch.

top_p
number
Intervalo obrigatório: 0 <= x <= 1
truncation
enum<string>
Opções disponíveis:
auto,
disabled
user
string
prompt_cache_key
string | null
safety_identifier
string | null
modalities
enum<string>[]
Opções disponíveis:
text,
image,
audio
image_config
object
provider_options
object

Opções específicas do provedor, se necessário.

usage
boolean
meta
boolean
echo_upstream_request
boolean
debug
object

Controles de depuração do gateway. Essas opções nunca são encaminhadas ao provedor.

provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

Resposta

Resposta

id
string
object
string
created
integer
model
string
provider
string
provider_id
string
nativeResponseId
string | null
status
enum<string>
Opções disponíveis:
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 modificação em 2 de outubro de 2026