Anthropic Messages
Blocos de texto e ferramentas usando o subconjunto documentado do protocolo Messages.
Atualizado em 31 de outubro de 2026 · Contrato 0.2.0
Contrato de requisição
Forneça o cabeçalho anthropic-version atual e max_tokens. Use texto user/assistant e texto system no nível superior. O adaptador também aceita texto com role system dentro dos limites. Este protocolo disponibiliza modelos NotHoly, não pesos Claude.
Ferramentas e ordem dos resultados
Blocos tool_use do assistant se associam a blocos tool_result de user. Os resultados precedem o novo texto do usuário. Texto do assistant após blocos de uso de ferramenta não é compatível, para evitar reordenação silenciosa do conteúdo. O cliente executa as funções.
Streaming nativo incremental
O stream envia message_start, eventos content_block_start/delta/stop indexados, message_delta e message_stop quando há conclusão bem-sucedida. O texto e o progresso validado dos argumentos de ferramentas chegam durante a geração. Uma falha emite um evento de erro nativo, sem um falso evento terminal de sucesso. Os acumuladores dos SDKs oficiais reconstroem o resultado.
Recursos não compatíveis
Imagens, documentos, controles de cache, controles de thinking, ferramentas de servidor, sequências de parada, amostragem e opções explícitas de controle de paralelismo são rejeitados. O conteúdo de thinking exposto pelo provedor, quando compatível, usa uma assinatura vazia e x-notholy-thinking-signature: unavailable; nenhuma assinatura de integridade Claude é inventada. Somente esses blocos de assistant sem assinatura podem ser enviados de volta. O uso de entrada comum exclui os tokens de leitura de cache.
Exemplo de requisição
Use sua chave de cliente e um modelo publicado. Copiar um exemplo não envia uma requisição.
curl https://api.notholy.com/v1/messages \
-H "Authorization: Bearer $NOTHOLY_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "Content-Type: application/json" \
-d '{
"model": "notholy-pulse",
"messages": [
{
"role": "user",
"content": "Explain least privilege."
}
],
"max_tokens": 256
}'Fixture de contrato HTTP. Verificações com fixtures são distintas da disponibilidade de modelos ao vivo.
Campos de requisição
Gerado a partir do contrato versionado. As regras de refinamento acima continuam valendo.
systemstring | array<object>Mostrar variantes aceitas
Variante 1stringAté 1.048.576 caracteres.
Variante 2array<object>Até 128 itens.
Mostrar campos do item
type"text"obrigatóriotextstringobrigatórioAté 1.048.576 caracteres.
modelstringobrigatórioAté 100 caracteres.
max_tokensintegerobrigatórioMínimo de 1. Máximo de 512.000.
messagesarray<object>obrigatórioAté 128 itens. Pelo menos 1 item.
Mostrar campos do item
role"user" | "assistant" | "system"obrigatóriocontentstring | array<object | object | object | object>obrigatórioMostrar variantes aceitas
Variante 1stringAté 1.048.576 caracteres.
Variante 2array<object | object | object | object>Até 128 itens. Pelo menos 1 item.
streambooleantoolsarray<object>Até 8 itens.
Mostrar campos do item
namestringobrigatóriodescriptionstringAté 1.000 caracteres.
input_schemaobjectobrigatórioMostrar campos do objeto
type"object"obrigatóriopropertiesobjectrequiredarray<string>additionalPropertiesbooleantool_choiceobject | objectMostrar variantes aceitas
Variante 1objectCampos desconhecidos são rejeitados.
Mostrar campos do objeto
type"auto" | "any" | "none"obrigatórioVariante 2objectCampos desconhecidos são rejeitados.
Mostrar campos do objeto
type"tool"obrigatórionamestringobrigatórioSchema da resposta
idstringobrigatóriotype"message"obrigatóriorole"assistant"obrigatóriocontentarray<object | object | object>obrigatóriomodelstringobrigatóriostop_reason"end_turn" | "tool_use" | "max_tokens" | nullobrigatóriostop_sequencenullobrigatóriousageobjectobrigatórioCampos desconhecidos são rejeitados.
Mostrar campos do objeto
input_tokensintegerobrigatórioMínimo de 0. Máximo de 9.007.199.254.740.991.
output_tokensintegerobrigatórioMínimo de 0. Máximo de 9.007.199.254.740.991.
cache_creation_input_tokensintegerobrigatórioMínimo de 0. Máximo de 9.007.199.254.740.991.
cache_read_input_tokensintegerobrigatórioMínimo de 0. Máximo de 9.007.199.254.740.991.