Skip to main content

Resposta curta

A Base URL deve corresponder ao protocolo esperado pela ferramenta. O Claude Code normalmente usa o endereço raiz compatível com Anthropic. Codex CLI, Cursor, Cline, OpenCode, OpenClaw e outras ferramentas externas normalmente usam o endereço /v1 compatível com OpenAI. No BetterToken: Não tente adivinhar o caminho. A API Key, a Base URL e o Model ID devem vir do mesmo provedor ou gateway.

Por que existem Base URL diferentes

Cada SDK acrescenta os caminhos de uma forma diferente. O mesmo nome de modelo não significa que a mesma Base URL funcione em todos os lugares. O protocolo da ferramenta, a Base URL, a API Key, o provedor e o Model ID precisam corresponder.

Referência rápida

Erros comuns

Ordem recomendada para resolver problemas

  1. Confirme se a ferramenta espera uma API compatível com OpenAI ou Anthropic.
  2. Verifique se a Base URL corresponde a esse protocolo.
  3. Verifique se a API Key pertence ao mesmo serviço.
  4. Verifique se o Model ID vem do model plaza e pertence ao provedor atual.
  5. Envie uma requisição mínima de teste, como hello.

Exemplos de código

Ferramentas compatíveis com OpenAI normalmente usam o endereço /v1:
Configurações compatíveis com Claude ou Anthropic normalmente usam o endereço raiz:

Sobre o BetterToken

O BetterToken oferece acesso compatível com Anthropic e OpenAI. Você pode gerenciar API Keys, saldo e registros de uso no mesmo painel, mas cada cliente ainda precisa do endereço do protocolo ao qual oferece suporte. Regra rápida: o Claude Code usa https://www.bettertoken.ai; Codex CLI, Cursor, Cline, OpenCode e OpenClaw usam https://www.bettertoken.ai/v1.

Documentação relacionada