Modelos de textoUsuários avançadosAtualizado em
POST/v1/messages

Console da API

POST/v1/messages
Ver chaves

As requisições usam a chave informada e seguem a cobrança padrão da API.

Claude Sonnet 5.5

ID da solicitação claude-sonnet-5-5

Protocolos

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

  • Anthropic Messages · x-api-key: YOUR_API_KEY

Parâmetros da requisição

POST /v1/messages

CampoTipoObrigatórioDescrição
modelstringObrigatórioDefina o ID do modelo como claude-sonnet-5-5.
messagesobject[]ObrigatórioEnvie as mensagens user e assistant em ordem. Coloque instruções de sistema no campo system de nível superior.
messages[].contentstring / object[]ObrigatórioCorpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
messages[].content[]objectCondicionalUse um bloco de conteúdo com type: image e coloque os dados da imagem em source. Os formatos aceitos dependem do endpoint.
systemstring / object[]OpcionalInstruções de sistema em texto ou em um array de blocos de texto.
max_tokensintegerObrigatórioLimita o número de tokens de saída. O limite aceito depende do modelo e do endpoint.
streambooleanOpcionaltrue solicita um fluxo SSE. false solicita uma resposta JSON. Os modos disponíveis dependem do endpoint.
thinking.typestringOpcionalUse adaptive ou between_tools. A segunda opção limita o raciocínio aos intervalos entre chamadas de ferramentas.
output_config.effortstringCondicionalNível de esforço de raciocínio solicitado. Os níveis disponíveis e a possibilidade de desativá-lo dependem do modelo e do endpoint.
toolsobject[]CondicionalDefinições das ferramentas disponíveis ao modelo. Os tipos de ferramenta e formatos de parâmetros dependem do protocolo e do endpoint.
tool_choiceobjectCondicionalUse type: auto para ferramentas comuns. Este modelo não aceita forçar a chamada de ferramentas comuns com any ou tool.

POST /v1/messages/count_tokens

CampoTipoObrigatórioDescrição
modelstringObrigatórioDefina o ID do modelo como claude-sonnet-5-5.
messagesobject[]ObrigatórioEnvie as mensagens user e assistant em ordem. Coloque instruções de sistema no campo system de nível superior.
messages[].contentstring / object[]ObrigatórioCorpo da mensagem. Use texto simples ou um array de blocos de conteúdo definidos pelo protocolo.
messages[].content[]objectCondicionalUse um bloco de conteúdo com type: image e coloque os dados da imagem em source. Os formatos aceitos dependem do endpoint.
systemstring / object[]OpcionalInstruções de sistema em texto ou em um array de blocos de texto.
toolsobject[]CondicionalDefinições de ferramentas incluídas na contagem de tokens de entrada. Envie as mesmas do pedido Messages.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Anthropic Messages

bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "claude-sonnet-5-5",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "claude-sonnet-5-5",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Ler a resposta

  • Anthropic Messages · Leia os blocos do tipo text em content[]. Em streaming, processe os eventos SSE de blocos de conteúdo na ordem. JSON · SSE
  • Count Tokens · Leia a contagem de tokens de entrada em input_tokens.

Guia completo de integração

Recursos e limites

  • streaming · Compatível
  • tool_calling · Compatível
  • image_input · Condicional — Depende do endpoint compatível e do formato da solicitação
  • video_input · Não compatível

Aliases de compatibilidade e redirecionamentos aposentados

  • claude-sonnet-4-5, claude-sonnet-4-5-20250514, claude-sonnet-4-5-20250929, claude-sonnet-4-6 → claude-sonnet-5-5 (Redirecionamento aposentado)

Catálogo de recursos dos modelos · Ver preços

Guias relacionados

Instalar o Claude Code, Configurar a API e Resolver Erros no Windows

Instale o Claude Code, configure chave e URL da API, verifique o ambiente e resolva erros de autenticação, limites e conexão no Windows, macOS e Linux.

Anthropic Messages

Envie uma requisição HTTP no formato Anthropic Messages. Para configurar o Claude Code, consulte os guias relacionados.

Catálogo de recursos dos modelos

Compare modelos públicos de texto, imagem e vídeo por ID normalizado, protocolos, clientes, ferramentas, recursos de mídia, limites e data de revisão.

Criar conta e obter uma API Key