Docs da API de Claude e GPT: chaves, SDKs, clientes

Uma chave e duas base URLs compatíveis para modelos de produção, clientes e APIs de mídia.

Para um agente de IA

Travou? Passe para um agente de IA

Envie o link abaixo para qualquer agente de IA (Claude Code, Codex, Cursor…) e peça que ele configure o seu cliente: o link traz tudo o que um agente precisa, das configurações de cada cliente até a verificação.

Três passos

1. Pegue uma chave no painel

   Abra o painel, recarregue o saldo (ou resgate um código de marketplace) e toque em “Emitir chave”.

   app.oneprovider.dev Como funciona

2. Escolha o seu cliente

   Cada cliente tem um guia curto próprio.

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. Defina a base URL e a chave

   A chave vai no cabeçalho x-api-key ou Authorization: Bearer. O endereço depende do tipo de cliente:

   Anthropic (Claude Code, SDK da Anthropic), sem /v1 https://api.oneprovider.dev OpenAI (Codex, Cursor, SDK da OpenAI), com /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   Se a resposta trouxer uma lista de modelos, a chave está funcionando.

Próximo

• Modelos e preços
• Autenticação
• Messages API
• Chat Completions
• Painel e chaves
• Erros e diagnóstico

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 .