Uso de modelos

Como corrigir erros HTTP 400 do Claude sobre temperature?

Resolva erros do Claude sobre temperature, top_p ou top_k. Remova os campos de amostragem e confira valores adicionados por clientes, SDKs e verificações de integridade.

O que significa o erro?

Uma requisição ao Claude pode retornar um erro como este:

HTTP 400: claude-haiku-5-5 does not support non-default temperature

O erro também pode mencionar top_p ou top_k. Esses parâmetros de amostragem controlam a aleatoriedade ou o conjunto de tokens candidatos. Os valores enviados são incompatíveis com o modelo ou a versão da API.

Remova temperature, top_p e top_k da requisição. Não basta redefinir a temperatura para o valor padrão.

Por que isso acontece?

Restrições do modelo: Modelos mais recentes, incluindo Claude Haiku 5.5, rejeitam valores de amostragem diferentes dos padrões, mesmo com o raciocínio desativado. Veja as regras oficiais de amostragem.
Restrições da versão da API: A Anthropic Messages API, a partir da versão 2026-10-21, rejeita esses campos com qualquer valor, inclusive temperature: 1.0. Veja o guia oficial de migração.

As regras dependem do modelo e da API; não existe uma temperatura universal. Nas chamadas OpenAI-compatible, também remova os campos não aceitos. Não adicione nem altere anthropic-version para corrigir esse erro.

Como corrigir

Desative a amostragem personalizada nas configurações do modelo ou provedor, ou exclua os três campos do JSON da requisição. Enviar null, uma string vazia ou um número padrão não equivale a omitir o campo.
Confira os wrappers do SDK, os padrões globais, as predefinições de modelos e os scripts de verificação de integridade. Inspecione o corpo realmente enviado, não apenas a tela de configurações.
Se o cliente exigir esses campos, atualize-o ou use uma configuração que permita omiti-los. Em aplicações com vários modelos, ajuste apenas as requisições afetadas.
Salve e envie um teste de texto curto. Os testes são cobrados pelo uso real. Não repita requisições com os mesmos parâmetros inválidos.

Exemplo de corpo da requisição

Este corpo não inclui campos de amostragem. Substitua a mensagem pela sua tarefa e mantenha a Base URL e a autenticação da sua API.

{
  "model": "claude-haiku-5-5",
  "max_tokens": 4096,
  "messages": [
    {"role": "user", "content": "Reply with only: OK"}
  ]
}

Anthropic Messages: Use a Base URL https://bettertoken.ai, o caminho /v1/messages e sua BetterToken API Key em x-api-key.
OpenAI Chat Completions: Use a Base URL https://bettertoken.ai/v1, o caminho /chat/completions e Authorization: Bearer <BETTERTOKEN_API_KEY>.

Confira se a configuração compartilhada não adiciona os campos de amostragem novamente. Descreva o formato, o tamanho e o tom desejados no prompt.

O erro continua?

Leia o novo erro completo e confira se ele menciona o mesmo parâmetro. Envie ao suporte o Model ID, o cliente e sua versão, o caminho da API, o horário com fuso, o ID da requisição se disponível e os campos da requisição sem dados sensíveis. Não envie sua BetterToken API Key, cabeçalhos de autenticação ou conversas privadas.