Guia da API Claude: Preços, configuração e sua primeira solicitação

Para fazer sua primeira solicitação à API do Claude, crie uma chave do Console do Claude, armazene-a em uma variável de ambiente, acesse o endpoint “Messages” e leia o resultado retornado uso campos e calcular o custo do token. Este guia orienta você nesse processo, utilizando os IDs e preços atuais dos modelos, verificados em 8 de setembro de 2026.

Depois de entender o caminho da API, a próxima questão é: qual parte do seu trabalho diário realmente precisa de integração personalizada? Para pesquisa, redação, programação e produção criativa, GlobalGPT oferece uma maneira mais econômica de usar o Claude em conjunto com o GPT-5.6 Sol, o Gemini 3 Pro, o Kimi K3 e outros modelos líderes de mercado. Uma única assinatura reúne os modelos e um amplo conjunto de ferramentas de IA em um único painel, para que o trabalho possa avançar da ideia ao resultado final sem precisar ser dividido entre serviços separados. Quando você precisar integrar a IA à sua configuração de desenvolvimento, a CLI do GlobalGPT conecta esse mesmo espaço de trabalho ao seu terminal e às ferramentas de produção existentes.

Experimente o Claude Opus 5

O que é a API Claude?

A API Claude é a interface de desenvolvedor do Anthropic para o envio de solicitações estruturadas aos modelos Claude a partir de um aplicativo, script ou serviço de back-end. Você envia mensagens para um endpoint HTTPS e recebe uma resposta estruturada contendo o conteúdo gerado, além de metadados, como o modelo, o motivo da interrupção e o uso do token.

Assinaturas da API Claude x Claude.ai

O acesso à API e as assinaturas do Claude.ai atendem a diferentes necessidades. Um plano do Claude.ai oferece acesso ao produto de chat do Anthropic. A API é um acesso medido para desenvolvedores por meio do Claude Console, com cobrança separada com base no uso. A Central de Ajuda do Anthropic informa que o Claude Pro não inclui o uso da API do Console.

Se você precisar de uma explicação mais detalhada sobre a diferença entre planos para consumidores, o Código Claude e o faturamento por token, consulte nosso guia completo Guia de preços do Claude. Para este tutorial, o ponto importante é simples: crie e recarregue a conta da API separadamente de qualquer assinatura do Claude.ai.

O caminho de cinco etapas para uma primeira solicitação

1. Crie uma chave de API no Console do Claude.
2. Guarde-o no ANTHROPIC_API_KEY variável de ambiente.
3. Envie uma solicitação para https://api.anthropic.com/v1/messages.
4. Leia o conteúdo retornado e uso objeto.
5. Multiplique cada categoria de token pela taxa aplicável por milhão de tokens.

Preços da API Claude e IDs dos modelos atuais

O Anthropic apresenta os preços da API em dólares americanos por milhão de tokens, frequentemente abreviado como MTok. As entradas e saídas são cobradas separadamente. O armazenamento em cache de prompts aplica tarifas distintas para gravações de cinco minutos, gravações de uma hora e leituras do cache; portanto, uma estimativa confiável deve manter essas categorias separadas.

Modelos atuais e IDs exatos da API

Qual modelo você deve usar para este tutorial?

O Guia Rápido oficial utilizado claude-opus-5 no momento em que este guia foi verificado; portanto, os exemplos de cURL e Python abaixo utilizam o mesmo ID. Considere o Opus como um ponto de partida para o tutorial e, em seguida, escolha o modelo de produção com base na carga de trabalho, nas necessidades de qualidade, na latência e no orçamento. Os IDs dos modelos e o status do ciclo de vida podem sofrer alterações; portanto, verifique novamente as páginas “Modelos” e “Descontinuações” antes de implementar código de longa duração.

O que você precisa antes da sua primeira solicitação

Crie uma conta no Console do Claude e uma chave de API

Abra o Console do Claude, crie ou selecione a organização apropriada e crie uma chave de API. O Anthropic avisa que uma nova chave é exibida apenas uma vez; portanto, salve-a em um gerenciador de segredos aprovado ou em outro local seguro assim que ela aparecer. Não inclua a chave em uma captura de tela, documento compartilhado, repositório público ou código JavaScript do navegador.

Armazene a chave em uma variável de ambiente

Os exemplos esperam que a variável ANTHROPIC_API_KEY. Digite o valor real apenas no seu terminal privado ou no seu sistema de gerenciamento de segredos. O comando abaixo lê o valor sem exibi-lo na tela e, em seguida, o exporta para a sessão atual do shell:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

As variáveis de ambiente reduzem a exposição acidental, mas não constituem uma estratégia completa de gerenciamento de segredos. As aplicações em produção devem seguir as práticas de armazenamento de segredos e controle de acesso da plataforma de hospedagem.

Verifique o faturamento e escolha um limite de teste seguro

O faturamento da API é independente das assinaturas do Claude.ai. O Anthropic afirma que a maioria das organizações paga antecipadamente os créditos de uso, sendo que as organizações com faturamento mensal constituem uma exceção. Verifique se sua conta no Console pode fazer solicitações de API e, em seguida, faça uma primeira solicitação pequena com max_tokens: 128. Esse campo limita a produção gerada; ele não reserva nem garante 128 tokens de produção faturados.

Envie sua primeira solicitação à API Claude usando o cURL

O cURL é útil para visualizar diretamente a estrutura da solicitação. O exemplo abaixo utiliza o endpoint “Messages”, o tipo de conteúdo JSON, o cabeçalho da chave da API, o cabeçalho de versão do Anthropic, o ID verificado do modelo do Quickstart e uma mensagem do usuário.

Antes de executar qualquer um dos exemplos, adicione sua própria chave de API e confirme se o faturamento da API está habilitado para a organização. O código segue o formato de solicitação documentado pelo Anthropic e passou nas verificações de sintaxe locais, mas não há nenhuma resposta de conta ativa incluída aqui.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Responda com uma frase explicando o que é uma API."
    }]
  }'

Qual é a função de cada cabeçalho e campo JSON

Se o comando retornar um erro, verifique o status HTTP e o tipo de erro antes de alterar a solicitação. Erros de autenticação e cobrança exigem uma correção na conta, enquanto um JSON malformado ou um ID de modelo inválido exigem uma alteração na solicitação.

Envie a mesma solicitação com o SDK do Python

Instale o SDK oficial do Anthropic

python -m pip install anthropic

Utilize um ambiente virtual quando isso fizer parte do seu fluxo de trabalho normal com Python. O SDK lê ANTHROPIC_API_KEY do ambiente quando anthropic.Anthropic() é criado sem uma chave explícita.

Execute a solicitação equivalente em Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Responda com uma frase explicando o que é uma API.",
 }
    ],
)

for block in message.content:
    if block.type == "text":
 print(block.text)

print(message.usage)

Leia o texto retornado com segurança

Uma resposta de mensagem pode conter mais de um bloco de conteúdo; por isso, o exemplo verifica o tipo de cada bloco antes de exibir o texto. Em aplicações reais, também é recomendável manter o ID da solicitação disponível para suporte e registro em log, sem expô-lo publicamente, registrar o modelo retornado e o motivo da interrupção, além de tratar os erros da API de forma explícita.

Mantenha a verificação do bloco de conteúdo mesmo quando esperar uma resposta curta. Isso facilita a ampliação do exemplo quando uma resposta contém vários blocos, e a impressão message.usage fornece os números necessários para o cálculo de custos a seguir.

Como verificar o consumo e calcular o custo

Encontre o texto da resposta, o modelo, o motivo da interrupção e o ID da solicitação

O contrato de resposta da API de Mensagens inclui conteúdo gerado, o modelo que processou a solicitação e um motivo para a interrupção. A resposta HTTP também contém um identificador de solicitação que pode ajudar a equipe de suporte da Anthropic a rastrear um problema. Registre os identificadores com cuidado; não os publique junto com o conteúdo ou as credenciais dos clientes.

Verificar o uso de tokens de entrada, saída e cache

O uso O objeto informa as categorias de tokens necessárias para a análise de custos. No mínimo, procure os tokens de entrada e saída. Quando o cache de prompts for utilizado, mantenha separadas as gravações no cache a cada cinco minutos, as gravações no cache a cada hora e as leituras do cache, pois elas possuem taxas diferentes. O endpoint de contagem de tokens do Anthropic pode estimar os tokens de entrada antes de uma solicitação, mas a estimativa pode diferir ligeiramente do uso final de entrada e possui seus próprios limites de taxa.

Converter o uso de tokens em um custo estimado

Calcule cada categoria separadamente e, em seguida, some os resultados. Para um exemplo de planejamento utilizando o Claude Opus 5 com taxas globais padrão, 1.000 tokens de entrada não armazenados em cache custam 1.000 × $5 / 1.000.000 = $0,005, enquanto 300 tokens de saída custam 300 x $25 / 1.000.000 = $0,0075. O total estimado é de $0.0125. Substitua essas contagens ilustrativas de tokens pelo uso valores extraídos da sua própria resposta.

Calculadora de preços da API Claude

Use a calculadora para alterar o modelo, a contagem de solicitações, as categorias de tokens, o modo de cobrança e a região de inferência. O processamento em lote cobra pelo uso elegível a taxas padrão de 50%. A inferência restrita aos EUA aplica um fator de 1,1x a todas as categorias de tokens para modelos elegíveis Claude 4,6+; o modelo Claude Haiku 4,5 não é elegível, portanto essa combinação retorna um estado não suportado.

A estimativa serve como auxílio ao planejamento, não como fatura. Ela não inclui impostos, conversão de moeda, condições negociadas, o Fast Mode, cobranças por ferramentas de servidor e condições específicas da conta. Os preços e os critérios de elegibilidade podem sofrer alterações; portanto, verifique novamente a página oficial de preços antes de tomar qualquer decisão relacionada à compra ou à arquitetura.

A calculadora acima mostra a estrutura de custos das chamadas de API Claude programáveis e cobradas por uso. Para o trabalho diário que abrange vários modelos e recursos de IA, GlobalGPT oferece um tipo diferente de valor: uma única assinatura reúne diversos modelos e ferramentas populares em um único painel, facilitando a previsão de custos e evitando que as atividades de pesquisa, redação, programação e trabalho criativo fiquem espalhadas por assinaturas e interfaces diferentes. Sua CLI leva a mesma plataforma para o desenvolvimento baseado em terminal e para as ferramentas de produção que você já utiliza. Nosso guia para trabalhar com vários modelos de IA em um único lugar mostra como a plataforma mais ampla se encaixa.

Erros comuns na API Claude e suas soluções

Comece analisando o código de status HTTP e o tipo de erro Anthropic; em seguida, examine a solicitação sem expor a chave. O significado oficial restringe a pesquisa; a causa provável ainda depende da sua conta, do modelo selecionado, do formato da solicitação e do tráfego.

Uma ordem segura de depuração

1. Registre o status, o tipo de erro, a data e hora e o ID da solicitação, sem registrar a chave da API.
2. Verifique o endpoint, os cabeçalhos, a sintaxe JSON, o ID do modelo e o limite de tamanho da solicitação.
3. Verifique o faturamento da organização, as permissões, os cabeçalhos de limite de taxa e o ciclo de vida atual do modelo.
4. Refaça apenas as tentativas para erros que possam ser, razoavelmente, temporários, utilizando recuo exponencial limitado e jitter.
5. Se o erro persistir, reduza a solicitação ao menor caso reproduzível antes de entrar em contato com o suporte.

Os SDKs oficiais do Anthropic tentam novamente, por padrão, duas vezes em caso de erros de conexão, respostas 429 e respostas 5xx. A lógica de repetição de tentativas no nível do aplicativo ainda precisa de limites e do reconhecimento da idempotência, especialmente quando uma solicitação pode acionar ferramentas ou outra ação externa.

Como controlar os custos da API Claude

Definir limites conservadores de saída

Comece pelo menor max_tokens valor que ainda pode gerar uma resposta útil. Avalie o uso real da saída antes de aumentá-lo. Prompts mais curtos podem ajudar, mas remover instruções que impedem novas tentativas, erros ou saídas inutilizáveis pode acabar custando mais no geral.

Utilize o armazenamento em cache de prompts e o processamento em lote apenas quando for adequado

• Utilize o armazenamento em cache de prompts quando um prefixo de prompt substancial se repetir e o tempo de vida do cache for compatível com o fluxo de trabalho.
• Utilize o Batch para tarefas que possam ser concluídas de forma assíncrona; o uso elegível do Batch é cobrado à taxa padrão de 50%.
• Mantenha as gravações e as leituras do cache separadas nos relatórios, para que a economia seja visível, em vez de apenas presumida.
• Utilize a inferência exclusiva para os EUA somente quando o requisito de residência justificar seu fator de preço do token de 1,1x e o modelo selecionado for elegível.

Monitorar o uso, os limites de taxa e os limites de gastos

Acompanhe o número de solicitações, o ID do modelo, o uso de entradas e saídas, as categorias de cache, as tentativas de repetição e os erros. Defina alertas ou controles de gastos disponíveis para sua organização, mas não presuma que o nível ou limite de outra conta se aplique à sua. Nosso guia mais detalhado sobre Planos Claude, custos e limites da API abrange as principais formas de cobrança.

Próximos passos após sua primeira solicitação

Escolha o caminho certo para o seu próximo projeto

Para uma aplicação, consulte a referência oficial da API de Mensagens do Anthropic, as orientações sobre streaming, a documentação sobre o uso das ferramentas, as páginas sobre o ciclo de vida dos modelos e seu próprio plano de registro e avaliação. Defina uma estratégia de modelo de forma deliberada, lide com os erros antes de adicionar tráfego e calcule os custos com base no uso observado, em vez de considerar apenas o comprimento do prompt.

Se a programação é o seu principal caso de uso, nosso guia sobre usando Claude AI para codificação aborda maneiras práticas de passar de uma tarefa interativa de programação para um fluxo de trabalho repetível de desenvolvedor.

Quando um espaço de trabalho multimodelo é a melhor ferramenta

O acesso direto à API é a melhor opção quando você precisa de integração no nível do código, faturamento para desenvolvedores, metadados de solicitações ou controles oficiais da plataforma. Se o seu objetivo for redação interativa, pesquisa, planejamento ou comparação de resultados entre diferentes provedores sem precisar desenvolver um aplicativo, um espaço de trabalho multimodelo pode ser mais prático.

Perguntas frequentes

A API Claude é gratuita?

Não há nenhuma garantia de cota gratuita universal para a API. O uso da API Claude é cobrado separadamente por meio do Console Claude, e a Anthropic informa que a maioria das organizações financia esse uso com créditos pré-pagos, sendo que as organizações com faturamento mensal constituem uma exceção. Verifique as informações atuais no Console e os preços oficiais para sua organização antes de enviar solicitações.

Como faço para obter uma chave de API Claude?

Crie uma chave no Console Claude para a organização correspondente. O Anthropic avisa que a nova chave é exibida apenas uma vez; portanto, guarde-a em um local seguro quando ela aparecer. Carregue-a por meio de uma variável de ambiente do lado do servidor ou de um gerenciador de segredos, e nunca a exponha no código do navegador, em capturas de tela ou em um repositório público.

Qual ID de modelo Claude devo usar?

Este tutorial utiliza claude-opus-5 porque esse era o modelo indicado no Guia de Início Rápido oficial do Anthropic, conforme verificado em 8 de setembro de 2026. Escolha o modelo que melhor se adapte à sua carga de trabalho e ao seu orçamento e verifique novamente as páginas “Modelos” e “Descontinuidades” do Anthropic, pois os IDs dos modelos, os aliases e o status do ciclo de vida podem sofrer alterações.

Qual endpoint a API Claude utiliza?

A primeira solicitação deste guia utiliza o endpoint Messages em https://api.anthropic.com/v1/messages. Ela envia JSON com os cabeçalhos content-type, x-api-key e anthropic-version. O Anthropic também oferece outros recursos de API; portanto, consulte a página de referência para a operação que você está implementando.

O Claude Pro inclui créditos de API?

A Central de Ajuda do Anthropic informa que o Claude Pro não inclui o uso por meio do Claude Console. A assinatura do Claude.ai e o faturamento por API são produtos separados. Configure o faturamento por API no Console para solicitações de desenvolvedores e utilize nosso Guia de preços do Claude para uma comparação mais abrangente dos planos.

Quanto custa uma solicitação de API Claude?

O custo depende do modelo selecionado, dos tokens de entrada, dos tokens de saída, das gravações no cache, das leituras no cache, do modo em lote e da região de inferência elegível. Calcule cada categoria multiplicando o número de solicitações pelos tokens e pela respectiva taxa efetiva por milhão de tokens, dividindo o resultado por um milhão e, em seguida, some as categorias. Use a calculadora acima para obter uma estimativa.

Por que estou recebendo um erro 401?

Um erro 401 é um erro de autenticação. Verifique se a chave de API existe, se continua ativa, se pertence à organização pretendida e se chega ao servidor no x-api-key cabeçalho. Não imprima nem compartilhe a chave durante a depuração. Tentativas repetidas não corrigirão uma credencial ausente ou inválida.

Por que estou recebendo um erro 429?

Um código 429 significa que a solicitação excedeu um limite de taxa. Os limites podem variar de acordo com a organização e o nível de uso; portanto, verifique os cabeçalhos de limite de taxa retornados, bem como o Console atual ou a documentação. Reduza a simultaneidade, respeite o intervalo de repetição e utilize o backoff exponencial limitado com jitter, em vez de repetir imediatamente a mesma sequência de solicitações.

Nota sobre a origem e o grau de frescor: Os IDs dos modelos, preços, comportamento da API e políticas de suporte foram verificados com base na documentação oficial do Anthropic em 8 de setembro de 2026. Consulte as páginas atualizadas dos modelos e preços antes de utilizar o serviço em produção e, em seguida, execute os exemplos com sua própria chave do Claude Console, configuração de cobrança e acesso à conta.