Todos os Nomes de Modelos da API Anthropic: IDs e Aliases Atuais do Claude

Se você pesquisou por todos os nomes de modelos da API Anthropic, a resposta mais rápida é esta: nomes de exibição do Claude, IDs de modelo atuais e snapshots datados são todos rótulos de aparência válida, mas apenas o identificador exato da API pertence ao campo model. A Anthropic usa nomes legíveis para humanos nas páginas de produto, IDs de modelo datados para chamadas de API reproduzíveis e aliases para atualizações convenientes. Esses valores estão relacionados, mas não são intercambiáveis.

A regra prática é simples: use um ID de modelo exato quando precisar de comportamento repetível, use um alias quando você intencionalmente quiser que a Anthropic o mova para um snapshot mais recente, e nunca copie um nome de marketing para uma requisição de API sem verificar primeiro a lista oficial de modelos.

Se o seu próximo passo for o formato da requisição em vez do esquema de nomenclatura, combine este guia com a Documentação da API de Mensagens da Anthropic. Se você está escolhendo um fluxo de trabalho de codificação orientado ao Claude, Modelos Suportados pelo Claude Code é o melhor complemento.

O que é um nome de modelo da API Anthropic?

Um nome de modelo da API Anthropic é o identificador enviado no parâmetro model de uma requisição para a API de Mensagens. Ele informa à Anthropic qual família e snapshot do Claude devem processar a requisição.

Estas três formas são fáceis de confundir:

Tipo de valor	Exemplo	Melhor uso
Nome de exibição	Claude Sonnet	Documentação, interface do produto, conversas com leitores não técnicos
ID de modelo atual	claude-sonnet-5	Novas integrações usando um modelo listado na página de modelos atuais da Anthropic
ID de modelo datado	claude-haiku-4-5-20251001	Testes, fluxos de trabalho regulados, avaliações e implantações em produção que exigem reprodutibilidade

O catálogo exato muda com o tempo. Trate a página de modelos atuais da Anthropic e a página de descontinuações de modelos como a fonte da verdade, em vez de codificar uma lista copiada de um tutorial antigo.

Nomes de modelos Claude versus IDs de modelo Claude

Os nomes de modelos Claude são otimizados para pessoas. “Claude Sonnet” comunica o nível do produto, enquanto “Claude Haiku” sugere o nível mais rápido e de menor custo. A API precisa de um valor mais preciso porque uma família pode ter vários snapshots, regras de disponibilidade regional e datas de aposentadoria.

Um ID datado geralmente inclui:

1. A família Claude, como opus, sonnet ou haiku.
2. A geração principal do modelo.
3. Uma data de lançamento no formato YYYYMMDD.

Por exemplo, claude-haiku-4-5-20251001 identifica o snapshot do Haiku 4.5 lançado em 1º de outubro de 2025. A data faz parte do identificador; não é um carimbo de data/hora da requisição e não deve ser substituída pela data atual.

Alguns catálogos de modelos também expõem identificadores de nível de família mais curtos. Eles são convenientes quando você deseja um modelo suportado sem gerenciar um snapshot datado você mesmo. A compensação é que um ponteiro gerenciado pelo provedor pode mudar de comportamento após uma atualização, portanto, verifique a semântica do ID exato mostrado no catálogo atual da Anthropic.

IDs de modelo Claude comuns que você pode encontrar

Os seguintes IDs de API estavam listados como ativos na página de modelos atuais da Anthropic em 24 de julho de 2026. Esta tabela é uma orientação pontual, não um registro permanente. Verifique a documentação da Anthropic antes de usar qualquer ID em uma nova implantação.

Família Claude	ID da API atual	Função típica
Claude Opus 4.8	claude-opus-4-8	Raciocínio complexo e análise de alto risco
Claude Sonnet 5	claude-sonnet-5	Cargas de trabalho de produção de uso geral
Claude Haiku 4.5	claude-haiku-4-5-20251001	Classificação rápida, extração e respostas curtas
Claude Opus 4.7	claude-opus-4-7	Integrações Opus de geração recente que não migraram para 4.8
Claude Sonnet 4.6	claude-sonnet-4-6	Integrações Sonnet de geração recente que não migraram para Sonnet 5

Estes são identificadores, não garantias de que um modelo está disponível em todas as contas da Anthropic. Mesmo um ID atualmente listado pode falhar devido a permissões de conta, região, cota ou uma alteração posterior no ciclo de vida. IDs datados são reproduzíveis enquanto suportados, mas ainda assim são eventualmente descontinuados.

Como escolher entre Opus, Sonnet e Haiku

Escolha pela carga de trabalho, não pelo nome mais longo:

• Opus: Use quando raciocínio difícil, síntese de formato longo ou decisões de ferramentas complexas justificarem maior latência ou custo.
• Sonnet: Comece aqui para a maioria dos assistentes de produção, fluxos de trabalho de codificação e geração estruturada. Geralmente é a linha de base prática de qualidade versus latência.
• Haiku: Use para roteamento de alto volume, extração, moderação, reescritas curtas e outras tarefas onde o tempo de resposta importa mais do que a profundidade máxima de raciocínio.

Execute uma pequena avaliação com prompts representativos antes de trocar de família. Inclua entradas malformadas, contexto longo, chamadas de ferramenta, saída JSON e o comportamento de fallback que sua aplicação usa quando uma requisição falha. Um nome de modelo que parece um substituto direto ainda pode alterar a formatação de chamadas de ferramenta ou o comportamento em casos extremos.

Use o ID do modelo em uma requisição da API de Mensagens

O valor model pertence ao corpo JSON. Ele é separado do cabeçalho de versão da API e do modelo mostrado no aplicativo web do Claude.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "Explique por que os IDs de modelo da API devem ser fixados em produção."
      }
    ]
  }'

O cabeçalho anthropic-version descreve o contrato da API. Ele não seleciona o modelo Claude. Mantenha essas duas configurações independentes em sua configuração para que uma atualização da biblioteca do cliente não altere silenciosamente o roteamento do modelo.

Para uso do SDK, defina o mesmo identificador através do método de criação de mensagens do cliente e mantenha-o em um valor de configuração específico do ambiente. Não coloque uma chave de API ou um ID de modelo em um bundle do navegador; o roteamento do lado do servidor é mais fácil de proteger e testar.

Por que um ID de modelo da API pode parar de funcionar

Um invalid_request_error ou uma resposta “modelo não encontrado” geralmente se enquadra em uma destas categorias:

O nome de exibição foi usado em vez do ID

Claude Sonnet é um rótulo útil, mas não um valor de requisição confiável. Substitua-o por um ID ou alias listado na documentação do provedor.

O snapshot foi descontinuado

IDs datados são reproduzíveis apenas enquanto o provedor os suporta. Monitore o cronograma de descontinuação, defina um prazo de migração e teste a substituição antes da data de aposentadoria.

A conta não pode acessar o modelo

Um identificador válido ainda pode estar indisponível devido a permissões de conta, região, cota ou uma política da organização. Verifique o corpo da resposta e a configuração da conta em vez de alterar o prompt.

O roteador espera um nome específico do provedor

Gateways e APIs compatíveis com OpenAI podem normalizar nomes de modelo de forma diferente. A Anthropic atualmente documenta claude-sonnet-5, enquanto outro provedor pode expor um valor com namespace ou um alias de propriedade do provedor. Use o catálogo de modelos do gateway e não presuma que um ID do Claude é portátil entre todos os endpoints.

Usando fluxos de trabalho Claude através de um endpoint compatível

Se sua aplicação já usa o formato do cliente OpenAI, uma camada de compatibilidade pode reduzir o trabalho de migração. A Novita LLM API fornece um endpoint compatível com OpenAI para rotear modelos de código aberto suportados através de um formato de requisição de chat-completions familiar.

Isso não significa que todo ID de modelo Claude está automaticamente disponível lá. Mantenha o roteamento do provedor explícito:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/openai",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "user", "content": "Resuma este ticket de suporte em três tópicos."}
    ],
)

print(response.choices[0].message.content)

O padrão de design importante é um mapa provedor/modelo, não uma string global única:

MODELS = {
    "anthropic": "claude-sonnet-5",
    "novita": "moonshotai/kimi-k2.5",
}

Isso permite que você avalie um modelo Claude em relação a uma alternativa de código aberto sem reescrever a lógica de negócios. Antes de trocar, compare saída estruturada, chamadas de ferramenta, manipulação de contexto, latência e modos de falha — não apenas o nome de exibição ou o título do benchmark.

IDs de modelo em backends e sandboxes de agentes

Um agente geralmente chama um modelo muitas vezes: planejamento, seleção de ferramentas, correção de código e resposta final. Coloque o identificador do modelo na configuração do backend, não em argumentos de ferramenta controlados pelo usuário. Registre o provedor selecionado e o ID do modelo em cada execução para que uma avaliação possa ser reproduzida posteriormente.

Quando um agente executa código gerado, mantenha o roteamento do modelo separado do ambiente de execução. Um Agent Sandbox gerenciado pode isolar arquivos, pacotes e comandos, enquanto a configuração da API LLM permanece no serviço do agente. Essa separação torna possível alterar um alias de modelo ou testar um snapshot fixado sem alterar a imagem do sandbox.

Para agentes de produção, adicione três salvaguardas:

1. Valide o modelo configurado na inicialização com uma pequena requisição autenticada ou verificação do catálogo do provedor.
2. Mantenha um ID de fallback testado e torne a ativação do fallback visível na telemetria.
3. Armazene o ID do modelo, versão da API, versão do prompt e esquema da ferramenta com os resultados da avaliação.

FAQ

Qual é o nome de modelo Claude correto para a API?

Use o ID de modelo exato listado na documentação atual da Anthropic, como claude-sonnet-5 ou o datado claude-haiku-4-5-20251001. Não use um nome de exibição como “Claude Sonnet” por si só.

Um ID de modelo Claude datado é melhor que um alias?

Nenhum é sempre melhor. Um ID datado é preferível para reprodutibilidade e implantações controladas. Um alias é preferível quando você deseja um ponteiro de família mantido e tem testes de regressão para atualizações do provedor.

Posso usar IDs de modelo da Anthropic com uma API compatível com OpenAI?

Apenas se esse endpoint explicitamente suportar e documentar o ID. Compatível com OpenAI descreve a interface da requisição; não promete catálogos de modelos idênticos. Verifique os modelos suportados do endpoint e use seu nome de roteamento exato.

Como evitar que uma descontinuação de modelo quebre meu aplicativo?

Fixe um ID testado, monitore os avisos de descontinuação da Anthropic, teste a substituição antes da data de aposentadoria e mantenha o valor do modelo em configuração para que você possa alterá-lo sem enviar alterações de lógica de negócios.

Artigos Recomendados

• Simplificando a Integração de API LLM para Desenvolvedores
• A Melhor Plataforma de API LLM para Trocar de Provedor
• O que é um Agent Sandbox de IA?

Fontes

• Anthropic: Visão geral dos modelos
• Anthropic: Referência da API de modelos
• Anthropic: Referência da API de Mensagens
• Anthropic: Descontinuações de modelos
• Novita AI: API LLM