Autenticação

A OneProvider aceita tanto o Bearer no estilo OpenAI quanto o x-api-key no estilo Anthropic. Envie um dos dois, nunca ambos.

Formas de cabeçalho

A API aceita qualquer um dos cabeçalhos. Use o que o seu SDK já envia.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Variáveis de ambiente

Nos nossos exemplos, a chave fica em ONEPROVIDER_KEY. Já os clientes SDK leem por padrão, automaticamente, os próprios nomes nativos — ou você exporta a chave com esse nome, ou passa ONEPROVIDER_KEY explicitamente ao construtor. A tabela abaixo mostra o que cada ferramenta lê:

Verificar a autenticação

Chame /v1/models para uma verificação barata e sem efeitos colaterais:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Uma resposta bem-sucedida lista os modelos atuais. Um 401 aqui significa que a chave está malformada, foi revogada ou ainda não está ativa.

Onde guardar a chave

• Variáveis de ambiente — o padrão para a maioria dos casos.
• ~/.zshrc / ~/.bashrc com HISTCONTROL=ignorespace definido, para que comandos iniciados com espaço não entrem no histórico do shell.
• Gerenciadores de segredos: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• Arquivos .env por projeto — sempre no .gitignore.

Armadilhas comuns

• Barra final. https://api.oneprovider.dev/v1/ vs https://api.oneprovider.dev/v1 — alguns SDKs concatenam o caminho de forma ingênua. Use a forma sem barra final mostrada acima.
• Bearer duplo. Authorization: Bearer Bearer sk-... acontece quando uma ferramenta já acrescenta Bearer e você o adiciona de novo. Remova o prefixo na sua configuração.
• Cabeçalho de versão da Anthropic. Sempre inclua anthropic-version: 2023-06-01 em chamadas HTTP diretas. Os SDKs o adicionam por você.

Rotação de chaves

Emita uma nova chave no painel (“Chaves” → “Emitir uma chave”), atualize-a nos seus clientes e depois exclua a antiga. É instantâneo e gratuito, e o saldo é compartilhado por todas as chaves do painel. Mais em: Painel e chaves .

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .