Pular para o conteúdo principal
POST
Criar uma mensagem
Envie um payload da API Messages da Anthropic para /v1/messages e receba de volta uma resposta no formato da Anthropic, para qualquer modelo que o Phaseo roteia. Os campos de uso de ferramentas da Anthropic são aceitos, e o cabeçalho X-Phaseo-Strictness controla como os parâmetros não suportados são tratados. Defina stream: true para receber eventos enviados pelo servidor no formato da Anthropic (message_start, content_block_*, message_delta, message_stop). O streaming também funciona em loops de ferramentas.

Mensagens de sistema no meio da conversa

Adicione uma mensagem role: "system" a messages para uma instrução que vale a partir daquele ponto da conversa. O campo system de nível superior continua o mesmo, então um prefixo em cache ainda é aproveitado.
Uma mensagem de sistema aceita uma string ou blocos de texto. Ela precisa vir logo depois de um turno do usuário (ou de um turno do assistente que termina com um resultado de ferramenta de servidor) e ser a última mensagem ou ser seguida por um turno do assistente. Outras posições retornam 400. clear_at, output_config e blocos tool_addition ou tool_removal não são suportados.

Usar ferramentas de servidor

Adicione uma ferramenta phaseo: a tools e o Phaseo a executa quando o modelo a chama, convertendo-a para o formato de ferramenta da Anthropic no upstream e continuando o loop de ferramentas no servidor. /v1/messages aceita todas as ferramentas de servidor, exceto phaseo:apply_patch; o guia Ferramentas de servidor lista todas elas.
As chamadas de ferramentas de servidor são contabilizadas em usage.server_tool_use. O tipo antigo gateway:datetime continua funcionando. Com stream: true, o Phaseo executa os turnos de ferramenta por conta própria e depois transmite a continuação da resposta para você como um único stream.

Usar a pesquisa na web nativa da Anthropic

Quando o modelo e o provedor Anthropic roteados aceitam pesquisa na web nativa, passe diretamente a definição de ferramenta da Anthropic, por exemplo type: "web_search_20250305". O roteamento de provedores ainda filtra pelo suporte a web_search_options antes da execução.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json

Um campo opcional de nível superior enviado como null é tratado como não definido, como se tivesse sido omitido.

model
string
obrigatório
messages
object[]
obrigatório
Minimum array length: 1
max_tokens
integer
obrigatório
Intervalo obrigatório: x >= 1
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
prompt
object

Preenche o template de prompt salvo em um preset. Omita model ou use a mesma referência, e envie uma conversa vazia ou os turnos a adicionar depois do template.

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,
auto,
standard_only
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.

plugins
object[]

Plugins do gateway para esta solicitação. web adiciona busca na web e web-fetch adiciona a leitura de páginas a qualquer modelo; response-healing corrige JSON malformado em respostas estruturadas sem streaming. Os padrões do workspace e do preset são combinados com esta lista. Um id de plugin desconhecido retorna 400 unknown_gateway_plugin.

Adiciona à solicitação a ferramenta de servidor phaseo:web_search, para que qualquer modelo possa pesquisar na web. A solicitação é executada, e as buscas são contadas e cobradas, exatamente como com uma ferramenta phaseo:web_search. Se a solicitação já tiver uma ferramenta de busca na web, o plugin não adiciona nada. As demais opções são ignoradas.

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
context_management
object

Edição de contexto da Anthropic. edits aceita as estratégias clear_tool_uses_* e clear_thinking_* e é enviado à Anthropic com o cabeçalho beta correspondente. Os demais provedores executam a solicitação sem esse campo e listam context_management em X-Phaseo-Dropped-Params. Edições de compactação (compact_*) retornam 400.

user
string

Identificador do usuário final, como em Chat Completions. Os modelos Claude o recebem como metadata.user_id, a menos que metadata.user_id esteja definido.

prompt_cache_key
string | null

Agrupa solicitações relacionadas para que permaneçam no provedor que tem o cache de prompts delas. O Phaseo envia ao provedor um hash do seu workspace e desta chave, nunca a chave original.

stop_sequences
string[]
cache_control
object

Controle do cache de prompts. Use type ephemeral com um ttl opcional de 5m ou 1h. scope se aplica apenas a uma política de cache do Claude no nível superior. A Amazon Bedrock e o Google Vertex AI armazenam em cache o Claude 3.7 Sonnet, o 3.5 Sonnet e o 3 Opus por apenas 5 minutos; nessas rotas o ttl é removido, e um 1h removido é informado em X-Phaseo-Dropped-Params como cache_control.ttl.

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
context_management
object

Presente quando a solicitação usou context_management e a Anthropic aplicou uma edição. applied_edits lista cada edição com o que ela removeu. Em streams, vem no evento message_delta final.

Última modificação em 5 de novembro de 2026