Migrar da OpenAI

Três linhas de diff. O seu SDK da OpenAI continua funcionando.

O patch

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

Escolha pela carga de trabalho

Não inventamos uma equivalência um para um entre os nomes de modelos dos fabricantes. Escolha o nível atual do GPT conforme os requisitos de qualidade, custo e latência:

O que funciona sem alterações

• chat.completions.create com messages, temperature, max_tokens, stream.
• Function calling via tools; tool_choice: "auto".
• Modo JSON (response_format: {"type": "json_object"}).
• Streaming via iteradores assíncronos, tanto em Python quanto em Node.

O que muda

• seed e logprobs são ignorados em silêncio.
• Os IDs retornados têm o prefixo chatcmpl-op- em vez de chatcmpl-.
• O formato legado function_call é mapeado internamente para tool_use da Anthropic; a superfície da resposta não muda.

Usando a CLI Codex da OpenAI

Se você usa a CLI Codex da OpenAI, aponte-a para o nosso endpoint da Responses API e reutilize a mesma chave. A configuração completa está na página do cliente Codex — resumindo: ~/.codex/auth.json para a chave, ~/.codex/config.toml com base_url = "https://api.oneprovider.dev/v1" e wire_api = "responses".

Verificação pós-migração

response = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

Migrando do OpenRouter ou de outro gateway

O que muda no meu cliente?

Três configurações: base URL, chave e ID do modelo. SDKs da OpenAI e ferramentas compatíveis com a OpenAI usam https://api.oneprovider.dev/v1; o Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Uma única chave da OneProvider funciona nos dois.

Como os IDs de modelo são diferentes?

Os IDs da OneProvider não têm prefixo do fabricante, por exemplo claude-sonnet-5-5 ou gpt-6.1-terra. Copie-os da página de modelos : um ID desconhecido retorna um 400 que indica o problema.

O que a OneProvider acrescenta?

Endpoints nativos da Anthropic e compatíveis com a OpenAI sob uma única chave, um saldo pré-pago que não expira e não exige assinatura, recargas por cripto, cartões, Apple Pay, Google Pay ou SBP, limite de gastos e validade por chave e um registro de consumo de cada requisição. Pela nossa política, o texto dos prompts não é armazenado; os servidores ficam em Frankfurt.

Como comparo o custo?

Compare o mesmo modelo: as taxas por milhão de tokens, incluindo as de cache, estão na página de preços . Depois execute uma tarefa real e veja a cobrança no seu registro de Consumo.

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 .