Pular para a documentação

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

POST/v1/messages

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
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 1string

Até 1.048.576 caracteres.

Variante 2array<object>

Até 128 itens.

Mostrar campos do item
type"text"obrigatório

textstringobrigatório

Até 1.048.576 caracteres.

modelstringobrigatório

Até 100 caracteres.

max_tokensintegerobrigatório

Mínimo de 1. Máximo de 512.000.

messagesarray<object>obrigatório

Até 128 itens. Pelo menos 1 item.

Mostrar campos do item
role"user" | "assistant" | "system"obrigatório

contentstring | array<object | object | object | object>obrigatório

Mostrar variantes aceitas
Variante 1string

Até 1.048.576 caracteres.

Variante 2array<object | object | object | object>

Até 128 itens. Pelo menos 1 item.

streamboolean

toolsarray<object>

Até 8 itens.

Mostrar campos do item
namestringobrigatório

descriptionstring

Até 1.000 caracteres.

input_schemaobjectobrigatório

Mostrar campos do objeto
type"object"obrigatório

propertiesobject

requiredarray<string>

additionalPropertiesboolean

tool_choiceobject | object

Mostrar variantes aceitas
Variante 1object

Campos desconhecidos são rejeitados.

Mostrar campos do objeto
type"auto" | "any" | "none"obrigatório

Variante 2object

Campos desconhecidos são rejeitados.

Mostrar campos do objeto
type"tool"obrigatório

namestringobrigatório

Schema da resposta

idstringobrigatório

type"message"obrigatório

role"assistant"obrigatório

contentarray<object | object | object>obrigatório

modelstringobrigatório

stop_reason"end_turn" | "tool_use" | "max_tokens" | nullobrigatório

stop_sequencenullobrigatório

usageobjectobrigatório

Campos desconhecidos são rejeitados.

Mostrar campos do objeto
input_tokensintegerobrigatório

Mínimo de 0. Máximo de 9.007.199.254.740.991.

output_tokensintegerobrigatório

Mínimo de 0. Máximo de 9.007.199.254.740.991.

cache_creation_input_tokensintegerobrigatório

Mínimo de 0. Máximo de 9.007.199.254.740.991.

cache_read_input_tokensintegerobrigatório

Mínimo de 0. Máximo de 9.007.199.254.740.991.