Claude API: como criar uma chave e quanto custa

Atualização (9 de novembro de 2026): Claude Fable 5.2 e Mythos 5.2 foram lançados - preços, acesso e benchmarks no meu guia do Claude Fable 5.2.

👁 125 leituras

Claude API permite usar os modelos da Anthropic no seu próprio código: você paga por tokens, não por assinatura, e escolhe qual modelo usar em cada tarefa. Em poucos minutos, você cria uma chave no Console; a primeira chamada exige apenas algumas linhas de Python. O mais complicado é entender os preços: há cinco modelos, cache de prompts, processamento em lote e limites por nível. A seguir, explicamos como começar e apresentamos três cenários de custo, além de uma comparação com OpenAI e Gemini.

O que é o Claude API e o Console

O Console (platform.claude.com) é o painel para desenvolvedores: nele, você cria uma organização, gera chaves, adiciona créditos e acompanha o uso. A API fica no endereço api.anthropic.com, para onde seu programa envia mensagens e de onde recebe respostas. A conta é diferente da claude.ai: as assinaturas Pro e Max não incluem créditos de API, e o contrário também não se aplica. O uso da API segue termos comerciais; por padrão, os dados enviados não são usados para treinar os modelos.

O Claude Code funciona nos dois modos: com as assinaturas Pro e Max ou com uma chave de API. No artigo assinatura ou API, comparei quando cada opção pode valer mais a pena.

Como criar uma conta, gerar uma chave e adicionar créditos

1. Crie uma conta em platform.claude.com, usando e-mail ou uma conta do Google, e informe o nome da organização.
2. Na seção API Keys, clique em “Create Key”, escolha um nome e copie a chave imediatamente: o Console só a exibe uma vez. Guarde-a em uma variável de ambiente, nunca no código enviado a um repositório.
3. Em Billing, adicione um cartão e compre créditos. O pagamento é antecipado e feito em dólares.
4. Confira seu nível na seção Rate limits.

Os níveis atuais são Start, Build, Scale e Custom. Organizações novas podem começar no nível Evaluation, com limites menores que os padrão. Esses limites aumentam automaticamente conforme o histórico de uso. O limite mensal de gastos é de US$ 500 no Start, US$ 1.000 no Build e US$ 200.000 no Scale. No nível Start, o Sonnet 5 tem um limite de 1.000 solicitações e 2 milhões de tokens de entrada por minuto, mais do que suficiente para um aplicativo pequeno.

Preços do Claude API em dólares

Os valores por milhão de tokens, de acordo com a documentação oficial, são apresentados em dólares e não incluem impostos:

Três recursos podem reduzir a conta. Cache de prompts: gravar no cache custa 1,25 vez o preço de entrada para cinco minutos ou duas vezes o preço para uma hora; a leitura custa 10% do preço de entrada, e ainda menos nos modelos Opus 5.5 e Fable 5.1. O recurso já pode compensar na primeira leitura do cache. Batch API: solicitações que podem esperar algumas horas pelo processamento custam 50% menos na entrada e na saída. Janela de 1 milhão de tokens: nos modelos 4.6 ou posteriores, está disponível pelo preço padrão. Atenção ao tokenizador: os modelos 4.7 ou posteriores contabilizam cerca de 30% mais tokens para o mesmo texto que o Sonnet 4.6 e os modelos anteriores. A busca na web custa mais US$ 10 por 1.000 pesquisas.

Veja três exemplos de custo calculados com base nos preços da tabela:

• Chatbot para um site: 1.000 conversas por mês, com 3.000 tokens de entrada e 500 de saída cada, usando o Sonnet 5. São 3 milhões de tokens de entrada (US$ 6) mais 0,5 milhão de tokens de saída (US$ 5), totalizando US$ 11.
• Processamento de 500 documentos: 20.000 tokens por documento e 1.000 tokens de resposta, usando o Haiku 4.5. O custo é de US$ 10 mais US$ 2,50, totalizando US$ 12,50; com processamento em lote, fica em cerca de US$ 6,25.
• Agente de programação com Opus 5.5: 200 tarefas com 100.000 tokens de contexto cada, 80% deles em cache, e 5.000 tokens de saída. São US$ 16 pela entrada nova, US$ 3,20 pela leitura do cache e US$ 20 pela saída, cerca de US$ 39 no total.

Primeira chamada: Python e curl

Configure a chave na variável ANTHROPIC_API_KEY, instale a biblioteca com o comando pip install anthropic e execute:

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=500,
    messages=[{"role": "user", "content": "Resuma em três frases o que é o RGPD."}],
)
print(message.content[0].text)
print(message.usage)

O texto de exemplo acima é uma tradução do prompt de teste original em polonês; o exemplo traduzido não foi testado novamente. O mesmo pedido com curl:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":500,
       "messages":[{"role":"user","content":"Resuma em três frases o que é o RGPD."}]}'

O campo usage da resposta informa o número de tokens de entrada e saída, para você calcular o custo. Os erros mais comuns são: 401, chave inválida; 429, limite por minuto excedido - o cabeçalho retry-after informa quanto esperar - ou limite mensal de gastos atingido; 400 com uma mensagem sobre “specified API usage limits”, limite de gastos configurado por você na seção Billing. Na seção Usage, você pode ver o consumo por modelo e chave. Para dar ferramentas ao modelo, leia sobre como criar agentes com Claude API e MCP.

Claude API, OpenAI API e Gemini API: comparação

Os três provedores oferecem 50% de desconto no processamento em lote e cache de prompts. A diferença está na oferta gratuita: o Gemini tem um nível gratuito permanente, com uso de dados para melhorar os produtos; Anthropic e OpenAI não. Opinião editorial: quando os preços são semelhantes, a qualidade no seu caso de uso importa mais do que a tabela de preços.

Perguntas frequentes

O Claude API tem um nível gratuito?

Novos usuários recebem uma pequena quantidade de créditos gratuitos para testes. Não há um nível gratuito permanente como o do Gemini API.

Os dados enviados pela API são usados para treinar os modelos?

Por padrão, não. A API segue termos comerciais e os dados dos clientes não são usados para treinamento. O armazenamento padrão é de 30 dias; empresas podem negociar armazenamento zero.

Qual modelo escolher para começar?

O Sonnet 5 é um bom ponto de partida. Custa cinco vezes menos que o Fable 5.1 e atende à maioria das tarefas de texto. Use o Haiku 4.5 para classificação e processamento em grande escala; escolha o Opus 5.5 para raciocínio complexo e tarefas longas com agentes. Saiba mais no artigo sobre quanto custa o Claude.

// continue lendoGalaxy AI: o que é, quanto custa e como desativarGeralGemma 4 12B local ou via API: quanto custa?BenchmarksClaude Duet no Brasil: dá para usar? O que fazer agoraGuias