Documentação

Documentação

Chave de API da Anthropic (Claude)

Crie uma chave de API Anthropic Claude em platform.claude.com, em Settings → API keys: ela começa com sk-ant- e é exibida uma única vez. Uma chave Kunavo dá acesso aos mesmos modelos Claude pelo SDK da OpenAI ou pela API Messages nativa, sem exigir uma conta Anthropic.

Para obter uma chave de API Anthropic Claude, entre no Console do Claude em platform.claude.com, acesse Settings → API keys e clique em Create Key. Uma chave de API da Anthropic começa com sk-ant- e é exibida uma única vez durante a criação. O console da Anthropic foi transferido de console.anthropic.com para platform.claude.com, e agora a página das chaves fica em platform.claude.com/settings/keys. Uma chave de API da Anthropic autentica solicitações para https://api.anthropic.com com o cabeçalho x-api-key e um cabeçalho anthropic-version — não com Authorization: Bearer. A FAQ de preços da Anthropic informa que novos usuários recebem uma pequena quantidade de créditos gratuitos para testar a API; não há um plano gratuito além dessa concessão, portanto, o uso da API do Claude é cobrado por token depois que os créditos iniciais acabam.

A Kunavo é um gateway independente de API de IA compatível com a OpenAI: uma única chave de API e um saldo pré-pago permitem acessar Claude, GPT e modelos de imagem, vídeo e áudio, sem exigir uma conta em cada provedor. Uma chave de API Kunavo começa com sk-kn-, é criada em kunavo.com/app/keys e não exige uma conta Anthropic. A Kunavo disponibiliza o Claude tanto pelo endpoint compatível com OpenAI https://api.kunavo.com/v1/chat/completions quanto pelo endpoint Anthropic nativo https://api.kunavo.com/v1/messages, portanto, o SDK oficial da OpenAI pode chamar o Claude alterando apenas base_url. A Kunavo funciona no modelo pré-pago por uso, com recarga mínima de US$ 10, e não oferece crédito gratuito a novas contas.

Os detalhes de produto da Anthropic nesta página — endereço do console, caminho do menu, prefixo da chave, cabeçalho de autenticação e política de créditos gratuitos — foram verificados pela última vez com base na documentação oficial da API da Anthropic em 31 de agosto de 2026.

Opção A — uma chave de API diretamente da Anthropic

Uma chave do Console da Anthropic é a escolha certa quando o projeto só usará modelos Claude. A Anthropic cobra por token e oferece suporte a todos os recursos do Claude desde o dia em que são lançados.

  1. Acesse platform.claude.com e entre. O endereço antigo console.anthropic.com agora redireciona para o mesmo console.
  2. Acesse Settings → API keys (link direto: platform.claude.com/settings/keys) e clique em Create Key. As chaves da Anthropic começam com sk-ant-... e são exibidas uma única vez.
  3. Adicione uma forma de pagamento em Faturamento. A Anthropic concede uma pequena quantidade de créditos gratuitos a novos usuários e, depois, cobra por token.
  4. Envie a chave como x-api-key, junto com um cabeçalho anthropic-version.
# Anthropic direct — x-api-key, not Bearer
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": 256,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Uma consequência a considerar no planejamento: uma chave da Anthropic dá acesso apenas ao Claude. Um projeto que também chama modelos GPT, de imagem ou de vídeo precisa de uma conta, chave, SDK e fatura separados para cada provedor.

Opção B — uma chave Kunavo para Claude e todo o resto

A Kunavo disponibiliza o Claude por meio de uma API compatível com OpenAI e da API Messages nativa da Anthropic. Uma única chave sk-kn- dá acesso ao Claude e a todos os outros modelos do catálogo, usando um único saldo financiado pelo Stripe, sem exigir uma conta Anthropic.

Chave do Console da AnthropicChave Kunavo
ModelosSomente ClaudeClaude, GPT, imagem, vídeo, áudio
Ponto de extremidadeapi.anthropic.comapi.kunavo.com/v1
APIsAPI MessagesCompatível com OpenAI + API Messages
Cabeçalho de autenticaçãox-api-keyAuthorization: Bearer
Conta do provedorConta Anthropic necessáriaNão é necessária
FaturamentoAnthropic, por tokenUm único saldo financiado pelo Stripe
Formato da chavesk-ant-...sk-kn-...
  1. Crie uma conta Kunavo e faça uma recarga de US$ 10. A Kunavo funciona no modelo pré-pago por uso, e o saldo nunca expira.
  2. Gere uma chave em /app/keys. Uma chave Kunavo é exibida uma única vez; armazene-a em uma variável de ambiente.
  3. Configure o SDK da OpenAI para usar https://api.kunavo.com/v1 e chame um slug do Claude.

Chave de API do Claude vs. chave de API da Anthropic

“Chave de API da Anthropic” e “chave de API do Claude” são dois nomes para a mesma credencial. Anthropic é a empresa, Claude é a família de modelos, e a chave criada no Console do Claude autentica chamadas à API do Claude. O que diferencia as duas chaves abaixo é sua origem e os recursos aos quais dão acesso:

  • Chave do Console da Anthropic (sk-ant-...) — criada em platform.claude.com/settings/keys. Uma chave do Console da Anthropic chama apenas o Claude, e a Anthropic cobra por token.
  • Chave Kunavo (sk-kn-...) — criada em kunavo.com/app/keys. Uma chave Kunavo chama os mesmos modelos Claude pelo SDK da OpenAI ou pela API Messages nativa, além de modelos GPT, de imagem, vídeo e áudio, usando um único saldo financiado pelo Stripe e sem exigir uma conta Anthropic.

Chame o Claude com Python

Mantenha o SDK oficial da OpenAI. A migração inteira consiste em alterar base_url e o nome do modelo.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # the only line that changes
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)

Chame o Claude com Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);

Ou chame o Claude com curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'
O formato de solicitação nativo da Anthropic funciona com a mesma chave Kunavo: faça um POST para /v1/messages — consulte a referência da API Messages.

A chave de API do Claude não está funcionando

Uma chave de API do Claude que retorna 401 authentication_error quase sempre aponta para uma destas cinco causas: cabeçalho incorreto para o endpoint, chave enviada a um endpoint ao qual ela não pertence, espaços em branco ou aspas inseridos inadvertidamente na variável de ambiente, chave revogada ou URL base incorreta para essa chave.

A causa mais comum é uma incompatibilidade de cabeçalho. A API nativa da Anthropic espera x-api-key e anthropic-version. Endpoints compatíveis com OpenAI, incluindo os da Kunavo, esperam Authorization: Bearer. Uma chave sk-ant- funciona somente em api.anthropic.com, e uma chave sk-kn- funciona somente em api.kunavo.com.

SintomaCausa provávelCorreção
401 unauthorizedA chave está incorreta, foi revogada ou foi enviada com o cabeçalho errado para esse endpointCrie outra chave em /app/keys e envie Authorization: Bearer sk-kn-…
402 insufficient_quotaO saldo está zerado ou o limite de gastos por chave foi atingidoAdicione saldo ou aumente o limite dessa chave
model not foundSlug incorretoUse um slug exato, como claude-sonnet-5; consulte /models
429 rate limitExcesso de solicitações em um curto períodoAguarde e tente novamente, aumentando o intervalo exponencialmente

Cada erro abaixo tem uma página detalhada dedicada, com o JSON de erro exato, todas as causas conhecidas e correções prontas para copiar e colar: 401 invalid api key, 429 rate_limit_error, saldo de créditos insuficiente / 402, 529 overloaded e model_not_found.

Usar a API do Claude sem cartão de crédito

A Anthropic aceita os principais cartões de crédito para contas padrão da API do Claude e reserva o faturamento por fatura para clientes corporativos; portanto, no acesso direto, o cartão é um requisito prático.

É possível adicionar saldo à Kunavo sem usar cartão, por qualquer uma destas formas de pagamento: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). A Kunavo define os preços das recargas em USD, e o Stripe faz a conversão na página de checkout. Assim, um comprador brasileiro escaneia um código Pix para pagar um valor em reais, sem precisar procurar um cartão habilitado para compras internacionais. Também há carteiras digitais vinculadas a cartões, excluídas dessa lista intencionalmente, pois uma carteira vinculada a um cartão não responde à pergunta. A lista completa de formas de pagamento está na referência de cobrança.

Nenhuma das opções é gratuita. A Anthropic concede uma pequena quantidade de créditos gratuitos a novos usuários e, depois, cobra por token. A Kunavo não oferece crédito gratuito a novas contas e começa com uma recarga mínima de US$ 10. Quem procura acesso gratuito permanente à API do Claude não encontrará essa opção em nenhuma das duas.

Qual modelo Claude usar

  • claude-haiku-4-5 — o mais barato e rápido, para classificação e suporte em alto volume. A Kunavo cobra $0.70 por 1M de tokens de entrada e $3.50 por 1M de tokens de saída para o Claude Haiku 4.5.
  • claude-sonnet-5 — a opção equilibrada para a maioria das tarefas de raciocínio, recuperação de informações e programação: o Sonnet mais recente, com desempenho próximo ao Opus em programação e tarefas com agentes. A Kunavo cobra $1.40 / $7.00 por 1M tokens para o Claude Sonnet 5, ante o preço de tabela de $2.00 / $10.00 da Anthropic.
  • claude-sonnet-4-6 — o Sonnet anterior, para prompts já ajustados a ele. A Kunavo cobra $2.10 / $10.50 por 1M tokens para o Claude Sonnet 4.6.
  • claude-opus-5 — para raciocínio complexo e contextos longos. A Kunavo cobra $3.50 / $17.50 por 1M tokens para o Claude Opus 5, ante o preço de tabela de $5.00 / $25.00 da Anthropic.
  • claude-fable-5 — o modelo mais capaz da Anthropic, para raciocínio de fronteira e agentes com horizontes longos, lançado em 1º de setembro de 2026. A Kunavo cobra $7.00 / $35.00 por 1M tokens, ante o preço de tabela de $10.00 / $50.00 da Anthropic. A versão anterior, claude-fable-5, continua disponível pela mesma tarifa.
Para ver as tarifas de cada modelo e exemplos práticos de custos, consulte o guia de preços da API do Claude.

Lista de verificação de segurança para chaves de API

  • Nunca exponha uma chave de API no lado do cliente. Encaminhe todas as chamadas por um servidor controlado pelo desenvolvedor.
  • Use uma chave de API por projeto ou ambiente para poder revogar uma chave exposta sem interromper todo o restante.
  • Alterne as chaves de API trimestralmente. A Kunavo permite várias chaves ativas ao mesmo tempo, o que cria um período de sobreposição adequado para a rotação.

Perguntas frequentes

Como obtenho uma chave de API do Anthropic Claude?

Para obter uma chave de API do Anthropic Claude, entre no Console do Claude em platform.claude.com, acesse Settings → API keys e clique em Create Key. Uma chave de API da Anthropic começa com sk-ant- e é exibida uma única vez durante a criação; por isso, ela precisa ser copiada e armazenada nesse momento. O console da Anthropic foi transferido de console.anthropic.com para platform.claude.com, e a página das chaves fica em platform.claude.com/settings/keys. Uma chave de API da Anthropic autentica solicitações para https://api.anthropic.com usando o cabeçalho x-api-key junto com um cabeçalho anthropic-version, e não um cabeçalho Authorization: Bearer.

Uma chave de API da Anthropic é igual a uma chave de API do Claude?

Uma chave de API da Anthropic e uma chave de API do Claude são a mesma credencial, com dois nomes. Anthropic é a empresa, Claude é a família de modelos, e a chave criada no Console do Claude autentica chamadas à API do Claude. Uma chave de API Kunavo (sk-kn-...) é uma credencial diferente, de outra empresa, que dá acesso aos mesmos modelos Claude, além de modelos GPT e de mídia, por meio de um único endpoint compatível com OpenAI.

A API do Claude é gratuita?

A API do Claude não é gratuita de forma contínua. A FAQ de preços da Anthropic informa que novos usuários recebem uma pequena quantidade de créditos gratuitos para testar a API; a Anthropic não divulga o valor desses créditos, e não há um plano gratuito além deles. Portanto, o uso da API do Claude é cobrado por token depois que os créditos iniciais acabam. A Kunavo também não oferece crédito gratuito a novas contas: uma conta Kunavo começa com uma recarga mínima de US$ 10, o saldo nunca expira e chamadas 4xx e 5xx com falha nunca são cobradas.

Por que minha chave de API do Claude não está funcionando?

Uma chave de API do Claude que retorna 401 authentication_error quase sempre aponta para uma destas cinco causas: cabeçalho incorreto para o endpoint, chave enviada a um endpoint ao qual ela não pertence, espaços em branco ou aspas inseridos inadvertidamente na variável de ambiente, chave revogada ou URL base incorreta. A API nativa da Anthropic em api.anthropic.com espera x-api-key e anthropic-version; endpoints compatíveis com OpenAI esperam Authorization: Bearer. Uma chave sk-ant- funciona somente em api.anthropic.com, e uma chave Kunavo sk-kn- funciona somente em api.kunavo.com.

Posso usar a API do Claude sem cartão de crédito?

A Anthropic aceita os principais cartões de crédito para contas padrão da API do Claude e reserva o faturamento por fatura para clientes corporativos; portanto, no acesso direto, o cartão é um requisito prático. É possível adicionar saldo à Kunavo sem cartão por várias formas de pagamento: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). A Kunavo define os preços das recargas em USD, e o Stripe faz a conversão na página de checkout. É assim que um comprador brasileiro paga em reais um preço em dólares. Nenhuma das opções oferece acesso gratuito contínuo: usar o Claude significa pagar pelos tokens em ambas.

Posso chamar o Claude com o SDK da OpenAI?

É possível chamar o Claude com o SDK oficial da OpenAI usando o endpoint da Kunavo compatível com OpenAI. Configure base_url como https://api.kunavo.com/v1, passe uma chave Kunavo como token bearer e defina model como um slug do Claude, por exemplo, claude-sonnet-5. A própria API da Anthropic em api.anthropic.com não aceita solicitações de conclusão de chat no formato da OpenAI; portanto, para chamar o Claude diretamente, é necessário usar o SDK da Anthropic ou a API Messages nativa.

Qual é a diferença entre uma chave de API da Anthropic e uma chave de API da Kunavo?

Uma chave de API da Anthropic chama apenas modelos Claude e é cobrada pela Anthropic. Uma chave de API da Kunavo chama Claude, além de modelos GPT, de imagem, vídeo e áudio, por meio de uma única API compatível com OpenAI, com cobrança em um único saldo financiado pelo Stripe. Uma chave de API da Anthropic exige uma conta Anthropic; uma chave de API da Kunavo, não.

Com qual modelo Claude devo começar?

Comece com claude-sonnet-5, a opção equilibrada para a maioria das tarefas de raciocínio, recuperação de informações e programação. Use claude-haiku-4-5 para classificação e suporte em alto volume e baixo custo. Use claude-opus-5 para raciocínio complexo e recorra ao claude-fable-5, o modelo mais capaz da Anthropic, apenas para raciocínio de fronteira e agentes com horizontes longos.

Quanto custa a API do Claude?

A Anthropic cobra pelo uso da API do Claude por token, com tarifas que variam conforme a categoria do modelo: Claude Haiku 4.5 é o mais barato, e Claude Fable 5, o mais caro. A Kunavo oferece os mesmos modelos Claude por valores inferiores ao preço de tabela da Anthropic em todos os modelos: Claude Opus 5 custa $3.50 / $17.50 por 1M tokens, comparado aos $5.00 / $25.00 da Anthropic; Claude Haiku 4.5 custa $0.70 / $3.50, comparado aos $1.00 / $5.00 da Anthropic; e Claude Sonnet 5 custa $1.40 / $7.00, comparado à tarifa introdutória de $2.00 / $10.00 que a Anthropic tornou seu preço padrão permanente em 31 de agosto de 2026.

A Kunavo faz parte da Anthropic?

A Kunavo é um gateway independente que revende acesso a esses modelos. A Kunavo não é a Anthropic, o Google nem a OpenAI, e não treina nem hospeda os modelos que disponibiliza.

O que a Kunavo é e o que não é

A Kunavo é um gateway independente de API de IA compatível com a OpenAI: uma única chave de API e um saldo pré-pago permitem acessar Claude, GPT e modelos de imagem, vídeo e áudio, sem exigir uma conta em cada provedor.

A Kunavo é um gateway independente que revende acesso a esses modelos. A Kunavo não é a Anthropic, o Google nem a OpenAI, e não treina nem hospeda os modelos que disponibiliza.

A documentação da própria Anthropic em platform.claude.com é a fonte oficial para informações sobre produtos, preços e políticas da Anthropic. Esta página reproduz o procedimento publicado pela Anthropic, com a data em que cada informação foi verificada, e apresenta ao lado a alternativa da Kunavo.

Próximos passos