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

ID da solicitação claude-sonnet-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.
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.
temperaturenumberCondicionalControla a aleatoriedade da amostragem. Os valores aceitos e a aplicação do campo dependem do modelo e do endpoint.
top_pnumberCondicionalLimita candidatos da amostragem por probabilidade acumulada. Use quando o modelo e o endpoint oferecerem suporte.
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_choiceobjectCondicionalControla a seleção de ferramentas. Use seleção forçada ou nominal apenas se o endpoint oferecer suporte.

POST /v1/messages/count_tokens

CampoTipoObrigatórioDescrição
modelstringObrigatórioDefina o ID do modelo como claude-sonnet-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",
  "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",
  "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

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