Migre do OpenRouter

Prepare sua conta

Atualizar configuração

Testar a conexão

Confirmar o uso

Solicitar recompensa

Notas avançadas

Nesta página

Esta plataforma

Mantenha sua integração compatível com OpenAI. Atualize o endereço, a chave API e o modelo, e valide antes de transferir o tráfego.

Iniciar migração

Criar chave API

Recompensa por migrar do OpenRouter

Recompensa: 10% do consumo líquido verificado, com limite de 500 USD. Crédito em até 30 dias após a aprovação.

Saiba mais

API compatível com OpenAI

Teste antes de transferir

Precisa de ajuda para configurar o cliente?

Documentação

Entre ou cadastre-se, confira o saldo e crie uma chave API ativa com cota suficiente e acesso ao modelo escolhido. Guarde-a no ambiente do servidor, nunca no código do navegador.

Cadastrar

Carteira

Modelos e preços

Comparação de configurações

Configuração

OpenRouter

URL base

Chave API

Nova chave desta plataforma

ID do modelo

ID exato do catálogo de modelos

Copie o ID exato em Modelos e preços ou consulte GET /v1/models com a nova chave. Remover o prefixo do provedor pode não bastar. A URL base do SDK termina em /v1; nas solicitações HTTP diretas, acrescente /chat/completions apenas uma vez.

Substitua YOUR_PLATFORM_API_KEY e YOUR_MODEL_ID. Configure primeiro as variáveis com cURL no macOS/Linux ou PowerShell no Windows; Python e Node.js leem as mesmas variáveis. Execute os exemplos no servidor ou terminal local.

Confirme HTTP 200 e um choices[0].message.content não vazio na solicitação básica de texto.

Confira o modelo, os tokens e a cobrança nos Registros de uso. Compare preços com o mesmo modelo e unidades de cobrança.

Registros de uso

Verifique a compatibilidade

Revise os recursos específicos do OpenRouter

Remova os cabeçalhos de atribuição do OpenRouter (HTTP-Referer, X-Title e X-OpenRouter-Title). Revise provider, models, route, transforms, plugins e sufixos como :free; regras de roteamento e preços não são transferidas automaticamente.

Comece com uma solicitação Chat Completions de texto simples. Teste separadamente ferramentas, JSON, imagens, raciocínio e streaming no modelo escolhido. Se usar um SDK OpenRouter ou perfil predefinido, mude para um cliente compatível com OpenAI ou configure um provedor personalizado.

Valide e transfira o tráfego

Ative stream: true e verifique os eventos incrementais e o encerramento do fluxo no cliente.

Transfira primeiro uma pequena parte do tráfego. Monitore erros e latência antes de ampliar. Guarde a configuração anterior para reverter; revogue as chaves sem uso após validar.

Solução de problemas

Use uma chave desta plataforma com Authorization: Bearer. Confira o estado, a validade, as restrições de IP e as permissões do modelo.

Confira a URL base /v1, o ID exato e os parâmetros aceitos. Remova os campos específicos do OpenRouter e tente uma solicitação mínima.

Confira saldo, cota, limites de taxa e disponibilidade do modelo na resposta de erro. Repita falhas temporárias com espera progressiva; não repita solicitações com credenciais inválidas ou saldo insuficiente.

O que é transferido?

Este guia migra a configuração API. Saldos, chaves, faturas e históricos de uso e conversas do OpenRouter não são importados. Faça backup das conversas no cliente e trate as faturas na plataforma original. Recompensas de migração exigem solicitação separada e análise.

Referências

Envie extratos ou faturas da OpenRouter, registros de consumo, imagens e uma explicação por escrito. O consumo líquido elegível deve ser de pelo menos 100 USD. Receba 10%, até 500 USD por pessoa ou empresa, como crédito exclusivo para consumo, que não pode ser reembolsado nem sacado. Cada cliente independente pode participar uma vez; solicitações rejeitadas podem ser reenviadas. O crédito é concedido em até 30 dias após a aprovação.

O consumo líquido exclui reembolsos, créditos promocionais e descontos. Mínimo de 100 USD.

PDF, JPG ou PNG. Até 5 arquivos, 10 MB cada.

URL base: https://routerra.ai/v1
Chave API: YOUR_PLATFORM_API_KEY
ID do modelo: YOUR_MODEL_ID

cURL

export OPENAI_BASE_URL='https://routerra.ai/v1'
export OPENAI_API_KEY='YOUR_PLATFORM_API_KEY'
export OPENAI_MODEL='YOUR_MODEL_ID'

curl --fail-with-body "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d @- <<EOF
{"model":"$OPENAI_MODEL","messages":[{"role":"user","content":"Hello"}]}
EOF

Python

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["OPENAI_BASE_URL"],
    api_key=os.environ["OPENAI_API_KEY"],
)
response = client.chat.completions.create(
    model=os.environ["OPENAI_MODEL"],
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

Node.js

// bun add openai
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: process.env.OPENAI_BASE_URL,
  apiKey: process.env.OPENAI_API_KEY,
});
const response = await client.chat.completions.create({
  model: process.env.OPENAI_MODEL,
  messages: [{ role: 'user', content: 'Hello' }],
});
console.log(response.choices[0].message.content);

PowerShell

$env:OPENAI_BASE_URL = 'https://routerra.ai/v1'
$env:OPENAI_API_KEY = 'YOUR_PLATFORM_API_KEY'
$env:OPENAI_MODEL = 'YOUR_MODEL_ID'

$body = @{
  model = $env:OPENAI_MODEL
  messages = @(@{ role = 'user'; content = 'Hello' })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Method Post `
  -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType 'application/json' -Body $body