Skip to main content
POST
Criar uma conclusão de chat

Ferramentas do servidor

/v1/chat/completions 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

Exemplo de data e hora

Quando uma ferramenta de servidor é usada, os dados de uso incluem:
phaseo:web_search adiciona server_tool_use.web_search_requests, server_tool_use.web_search_results e server_tool_use.web_search_extra_results. phaseo:web_fetch adiciona server_tool_use.web_fetch_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
messages
object[]
obrigatório
Minimum array length: 1
reasoning
object
reasoning_effort
enum<string>

Alias compatível com OpenAI para reasoning.effort.

Opções disponíveis:
none,
instant,
minimal,
low,
medium,
high,
xhigh,
max
frequency_penalty
number
Intervalo obrigatório: -2 <= x <= 2
logit_bias
object
max_completion_tokens
integer
Intervalo obrigatório: x >= 1
max_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
presence_penalty
number
Intervalo obrigatório: -2 <= x <= 2
seed
integer
Intervalo obrigatório: -9223372036854776000 <= x <= 9223372036854776000
store
boolean
stream
boolean
padrão:false
stream_options
object
temperature
number
padrão:1
Intervalo obrigatório: 0 <= x <= 2
tools
object[]

Definições de ferramentas para chamadas de função do modelo e ferramentas de servidor do gateway. As ferramentas integradas incluem data e hora, busca na web, busca de páginas, Advisor, Subagent, Fusion, busca de modelos, geração de imagens e criação de patches.

max_tool_calls
integer
Intervalo obrigatório: x >= 1
parallel_tool_calls
boolean
padrão:true
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
logprobs
boolean
padrão:false
top_logprobs
integer
Intervalo obrigatório: 0 <= x <= 20
top_p
number
Intervalo obrigatório: 0 <= x <= 1
stop
response_format
modalities
enum<string>[]
Opções disponíveis:
text,
image,
audio
image_config
object
usage
boolean
provider

Seletor de provedor. Use uma string para um único provedor ou opções de roteamento como { "only": ["groq"] }.

Opções disponíveis:
openai,
anthropic,
google-ai-studio,
gemini,
mistral,
x-ai,
xai,
groq,
together
provider_options
object

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

user_id
string
user
string
service_tier
enum<string>
Opções disponíveis:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
prompt_cache_key
string | null
safety_identifier
string | null
meta
boolean
padrão:false
echo_upstream_request
boolean
debug
object

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

Resposta

Resposta de conclusão de chat

id
string
nativeResponseId
string | null
object
string
created
integer
model
string
provider
string
choices
object[]
usage
object
Última modificação em 2 de outubro de 2026