Primeira solicitação à Claude API: chave, endpoint e verificação

1. Crie uma API Key da BetterToken

1. Entre no BetterToken Workspace.
2. Crie uma nova API Key para o key group Claude-compatible indicado na documentação atual.
3. Copie a chave uma única vez e guarde-a em um gerenciador de segredos ou em uma variável de ambiente local excluída do Git.
4. Consulte a documentação atual da API e a página de preços para confirmar o Model ID e a disponibilidade atuais.

Não cole a chave em código, prompts, capturas de tela, chamados de suporte ou repositórios públicos. Em equipes, cada pessoa deve usar sua própria conta e sua própria chave. Não use uma chave do Anthropic Console nem um login compartilhado do Claude.ai.

2. Confirme o endpoint Anthropic-compatible

A Base URL da BetterToken usada neste fluxo é:

https://bettertoken.ai/

Para uma chamada HTTP direta, o caminho completo é:

POST https://www.bettertoken.ai/v1/messages

Não acrescente /v1 à Base URL. Um SDK pode anexar o caminho do recurso; já o exemplo de curl abaixo precisa do caminho completo /v1/messages.

3. Envie a solicitação mínima

O comando abaixo separa a chave, a Base URL e o Model ID em variáveis de ambiente. Isso é mais seguro do que digitar os valores reais diretamente no histórico do shell.

export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="YOUR_MODEL_ID"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"Return only the word pong.\"}]
  }"

Substitua your_api_key e YOUR_MODEL_ID somente no seu ambiente local. Este artigo não fixa um nome de modelo: o Model ID exato e a disponibilidade podem mudar, portanto copie-os sempre da documentação ou da página de preços atual.

4. Verifique a resposta e o uso

Uma chamada bem-sucedida retorna HTTP 200 e uma mensagem JSON. Verifique pelo menos:

• se type é message;
• se content contém a resposta do modelo;
• se usage contém input_tokens e output_tokens.

O formato da resposta segue a referência da Anthropic Messages API. Essa compatibilidade de formato não transforma uma chave da BetterToken em uma chave da Anthropic.

Agora atualize o Workspace e associe o registro ao horário da solicitação. Confirme:

• o modelo usado;
• o status de sucesso ou erro;
• os tokens de entrada, saída e cache, quando aplicável;
• o custo cobrado.

Não presuma que o Workspace armazena o prompt completo ou o corpo integral da resposta. Use os campos de status e uso para confirmar o roteamento e o consumo.

5. Resolva erros comuns

404 Not Found

Confirme que a chamada HTTP direta inclui o caminho completo /v1/messages. Usar somente /messages deixa o caminho incompleto.

400 Bad Request

Revise estes campos:

• anthropic-version: 2023-06-01;
• content-type: application/json;
• um Model ID válido no momento;
• max_tokens como inteiro positivo;
• o array messages com pelo menos uma mensagem válida de user.

401 ou 403

Verifique:

• se a chave foi emitida pela BetterToken;
• se o key group selecionado permite o modelo solicitado;
• se a Base URL é exatamente https://bettertoken.ai;
• se não há espaços antes ou depois da chave copiada.

Nunca envie a chave real ao suporte. Compartilhe apenas o código do erro, o horário da solicitação e os nomes dos headers sem valores secretos.

429 Too Many Requests

Leia primeiro o corpo da resposta. Depois, aguarde antes de repetir uma única solicitação e confira a concorrência e os limites atuais da conta.

Nenhum registro no Workspace

Confirme que a solicitação foi enviada à Base URL da BetterToken. Variáveis de ambiente de outro provider ainda podem estar ativas no shell ou aplicativo atual.

Após o teste, você pode limpar as variáveis do shell:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL
unset CLAUDE_MODEL_ID

Em seguida, defina novamente os valores atuais e envie apenas uma solicitação. Um loop rápido de tentativas apenas repete a falha mais depressa, sem esclarecer a causa.

Próximo passo

Depois que a solicitação mínima funcionar, mova a chave para um armazenamento seguro de segredos, defina um timeout finito e use tentativas limitadas somente para falhas temporárias. Mantenha a documentação da BetterToken aberta e confira se cada nova solicitação aparece no Workspace com o modelo, o status e o uso esperados.