Uma linha e pronto
Um endereço, em três formatos. Cada bloco abaixo mostra um deles. Cada requisição é cobrada pelos tokens usados, e um HTTP 402 indica que o saldo acabou.
https://api.vanaapi.com
Nada após o host. Claude Code e Claude Desktop usam o endereço neste formato: defina duas variáveis de ambiente e inicie claude como de costume.
export ANTHROPIC_BASE_URL=https://api.vanaapi.com
export ANTHROPIC_AUTH_TOKEN=vana-your-key
claude
No Windows, defina as variáveis uma vez com setx e abra um novo terminal:
setx ANTHROPIC_BASE_URL https://api.vanaapi.com
setx ANTHROPIC_AUTH_TOKEN vana-your-key
Os modelos Claude estão disponíveis apenas no cliente oficial Claude Code ou Claude Desktop, na versão 2.1.285 ou mais recente. Essa regra vem do provedor. GPT, Gemini e as outras famílias funcionam com qualquer cliente ou SDK compatível com OpenAI.
https://api.vanaapi.com/v1
Adicione /v1 para tudo que usa o formato da OpenAI: os SDKs da OpenAI, Codex, Cursor, Cherry Studio e cURL. Use sua chave como chave de API.
- base_url
https://api.vanaapi.com/v1- api_key
vana-your-key- Destino das conversas
POST https://api.vanaapi.com/v1/chat/completions
import openai
vana = openai.OpenAI(base_url="https://api.vanaapi.com/v1", api_key="vana-your-key")
answer = vana.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Describe a quiet morning in one line."}],
)
print(answer.choices[0].message.content)
curl https://api.vanaapi.com/v1/chat/completions \
-H "Authorization: Bearer vana-your-key" -H "Content-Type: application/json" \
-X POST -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Hello"}]}'
Modelos GPT para começar: gpt-6.1-sol · gpt-6-astra · gpt-5.6-sol
O Codex lê os mesmos dois valores: defina base_url com o endereço que termina em /v1 e mantenha sua chave no ambiente.
https://api.vanaapi.com/v1beta
Os modelos Gemini usam seu protocolo nativo em /v1beta. O Gemini CLI adiciona essa parte sozinho, então informe o endereço sem esse sufixo.
export GOOGLE_GEMINI_BASE_URL=https://api.vanaapi.com
export GEMINI_API_KEY=vana-your-key
gemini
curl "https://api.vanaapi.com/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: vana-your-key" -H "Content-Type: application/json" \
-X POST -d '{"contents": [{"role": "user", "parts": [{"text": "Hello"}]}]}'
- Use apenas o domínio em GOOGLE_GEMINI_BASE_URL; não adicione /v1beta.
- Para streaming, use o método :streamGenerateContent?alt=sse no mesmo caminho do modelo.
- Os modelos Gemini não estão disponíveis em /v1/chat/completions.
Modelos Gemini: gemini-3.1-pro · gemini-4-argon · gemini-3.8-flash · gemini-2.5-flash