Uso de modelos

Como devo configurar a Base URL?

Entenda como a Base URL, os caminhos /v1, a API Key e o Model ID devem corresponder no Claude Code, Codex CLI, Cursor, Cline e outras ferramentas. Mais.

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:

Caso de uso	Base URL
Claude Code / compatível com Anthropic	`https://bettertoken.ai`
Codex CLI / compatível com OpenAI	`https://bettertoken.ai/v1`
Cursor, Cline, OpenCode, OpenClaw	`https://bettertoken.ai/v1`

Use https://bettertoken.ai no Claude Code e https://bettertoken.ai/v1 no Codex CLI e em ferramentas OpenAI-compatible. Escolha o endereço de acordo com o protocolo do cliente.

Por que existem Base URL diferentes

Cada SDK acrescenta os caminhos de uma forma diferente.

Protocolo ou tipo de ferramenta	Comportamento comum
SDK compatível com OpenAI	Normalmente chama recursos como chat completions ou responses em `/v1`
SDK compatível com Anthropic	Normalmente acrescenta os caminhos do endpoint de mensagens, por isso você não deve adicionar `/v1` novamente
Provedor integrado à ferramenta	Pode acrescentar caminhos automaticamente ou solicitar uma Base URL completa

Use https://bettertoken.ai no Claude Code e https://bettertoken.ai/v1 no Codex CLI e em ferramentas OpenAI-compatible. Escolha o endereço de acordo com o protocolo do cliente.

Referência rápida

Ferramenta	Configuração recomendada
Claude Code	`https://bettertoken.ai`, com uma BetterToken API Key
Claude Desktop Gateway	Siga a página do Gateway, incluindo o esquema de autenticação
Codex CLI	`https://bettertoken.ai/v1`, com uma BetterToken API Key
Cursor	`https://bettertoken.ai/v1`, com uma BetterToken API Key
Cline	`https://bettertoken.ai/v1`, usando um provedor OpenAI Compatible
OpenCode / OpenClaw	`https://bettertoken.ai/v1`, com uma BetterToken API Key

Erros comuns

Erro ou sintoma	Possível causa
`404 Not Found`	O caminho da Base URL não corresponde ao caminho esperado pelo SDK
`model not found`	Confira o Model ID exato na model plaza e informe-o nas configurações de modelo do cliente.
`invalid_api_key`	A API Key e a Base URL pertencem a serviços diferentes
A autenticação funciona, mas o modelo não está disponível	Confira o Model ID exato na model plaza e informe-o nas configurações de modelo do cliente.
As requisições continuam falhando	Um endereço compatível com Anthropic foi usado em uma ferramenta compatível com OpenAI, ou o contrário

Ordem recomendada para resolver problemas

Confirme se a ferramenta espera uma API compatível com OpenAI ou Anthropic.
Verifique se a Base URL corresponde a esse protocolo.
Verifique se a API Key pertence ao mesmo serviço.
Copie o Model ID exato da model plaza.
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:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai/v1"
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "hello"}]
)

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

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://bettertoken.ai"
)

message = client.messages.create(
    model="your-model-id",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}]
)

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://bettertoken.ai; Codex CLI, Cursor, Cline, OpenCode e OpenClaw usam https://bettertoken.ai/v1.