// Auth
Autenticação
Use a mesma virtual key (sk-...) em qualquer surface. O header muda conforme o formato escolhido - OpenAI usa Bearer token, Anthropic usa x-api-key.
Formato OpenAI (Bearer)
Recomendado para a maioria dos clientes. Funciona com SDK oficial da OpenAI, LangChain, LlamaIndex, Cursor, Continue, Aider e qualquer ferramenta OpenAI-compatible.
bash
curl https://openai.claudio.legal/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-4.6", "messages": [{"role":"user","content":"Hi"}]}'Formato Anthropic (x-api-key)
Use quando o cliente chamar o endpoint nativo /v1/messages - Claude Code, SDK oficial da Anthropic, Droid e similares.
bash
curl https://claude.claudio.legal/v1/messages \
-H "x-api-key: sk-..." \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-4.6","max_tokens":1024,"messages":[{"role":"user","content":"Hi"}]}'Variáveis de ambiente
Defina via .env e a maioria dos SDKs lê sozinho, sem precisar passar parâmetro.
.env
# OpenAI-compatible OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://openai.claudio.legal/v1 # Anthropic-compatible ANTHROPIC_API_KEY=sk-... ANTHROPIC_BASE_URL=https://claude.claudio.legal
Segurança
Nunca commit a virtual key no repositório. Use .env (no .gitignore), variáveis de ambiente do CI ou um secret manager. Se a chave vazar, revogue em /app/keys e gere uma nova.