Skip to main content
POST
Criar uma mensagem
/v1/messages aceita payloads da API Anthropic Messages e retorna respostas no formato Anthropic.

Transmissão contínua

Defina stream: true para receber eventos enviados pelo servidor no formato Anthropic (message_start, content_block_*, message_delta, message_stop).

Observações

  • Os campos de uso de ferramentas do Anthropic são compatíveis.
  • stream: true também funciona em loops de ferramentas. Para ferramentas de servidor gerenciadas pelo Gateway, a Phaseo pode materializar o turno upstream, continuar o loop e emitir novamente um stream sintético.
  • O formato nativo da ferramenta de busca na web do Anthropic também é aceito diretamente em tools, por exemplo type: "web_search_20250305".
  • O cabeçalho X-Phaseo-Strictness controla o tratamento de parâmetros não compatíveis.

Ferramentas do servidor

/v1/messages também aceita estas ferramentas de servidor gerenciadas pelo Gateway:
  • gateway:datetime
  • phaseo:web_search
  • phaseo:web_fetch
  • phaseo:advisor
  • phaseo:image_generation
A Phaseo converte essas ferramentas para o formato compatível com Anthropic no provedor upstream, executa-as no servidor e continua o loop de ferramentas.

Busca na web nativa do provedor

Quando um par compatível de modelo/provedor Anthropic oferece busca na web nativa, você também pode enviar diretamente a definição nativa da ferramenta:
O roteamento do provedor ainda verifica o suporte a web_search_options antes da execução.

Exemplo de data e hora

Quando usadas, as chamadas às ferramentas do servidor aparecem nos contadores usage.server_tool_use.*.

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
max_tokens
integer
obrigatório
Intervalo obrigatório: x >= 1
system
service_tier
enum<string>

Seleciona um nível de roteamento ou preço suportado nas APIs de texto compatíveis.

Opções disponíveis:
standard,
default,
fast,
ultrafast,
priority,
flex,
batch
temperature
number
Intervalo obrigatório: 0 <= x <= 1
top_p
number
Intervalo obrigatório: 0 <= x <= 1
top_k
integer
Intervalo obrigatório: x >= 1
tools
object[]

Ferramentas compatíveis com Anthropic e ferramentas de servidor gerenciadas pelo gateway.

tool_choice

Objeto ou string de escolha de ferramenta da Anthropic. Nomes de ferramentas de servidor gerenciadas pelo gateway também são aceitos e reescritos pelo gateway.

stream
boolean
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
reasoning
object
stop_sequences
string[]
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 da mensagem

id
string
type
string
role
enum<string>
Opções disponíveis:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object
Última modificação em 2 de outubro de 2026