Pular para o conteúdo
Ferramentas

OpenRouter: Como Usar 200+ Modelos de IA

Em vez de gerenciar 5 API keys diferentes, o OpenRouter centraliza tudo. Claude, GPT-4o, DeepSeek, Gemini e mais 200 modelos com uma chave só e um formato padrão

Por que isso é importante

Em vez de gerenciar 5 API keys diferentes, o OpenRouter centraliza tudo. Claude, GPT-4o, DeepSeek, Gemini e mais 200 modelos com uma chave só e um formato padrão de request.

Resumo

OpenRouter = uma API key, 200+ modelos. Crie conta em openrouter.ai, gere uma API key, aponte a URL base pra api.openrouter.ai/api/v1 e use com qualquer cliente OpenAI. Tem tier gratuito. Melhor custo-benefício: DeepSeek V3 e Qwen Coder.

Contexto

O problema de usar vários modelos de IA é gerenciar múltiplas API keys, formatos de request diferentes e faturamentos separados. O OpenRouter resolve isso centralizando tudo — você adiciona crédito numa conta só e acessa qualquer modelo disponível.

Antes de conhecer o OpenRouter, meu setup era: chave da OpenAI pro GPT-4o, chave da Anthropic pro Claude, chave do Google pro Gemini, conta na Mistral, e por aí vai. Cinco contas pra gerenciar, cinco cobranças diferentes no cartão, cinco formatos de API ligeiramente diferentes.

O OpenRouter é um proxy de LLMs: você manda o request pra ele no formato padrão OpenAI, especifica qual modelo quer, e ele repassa pro provedor correto. O seu código não muda quando você troca de modelo. Só a string do nome do modelo.

O Que E e Por Que Existe

O OpenRouter nasceu da dificuldade de comparar modelos em produção. Os criadores queriam trocar de GPT-4 pra Claude sem reescrever código toda vez. A solução foi criar uma camada de abstração que padroniza os requests e roteia pra cada provedor.

O negócio deles é cobrar uma margem pequena (geralmente 5-10%) sobre os preços originais dos provedores. Pra você, a conveniência vale isso — uma conta, um format, um lugar pra ver quanto gastou. Eles também têm fallback automático: se um provedor está fora do ar, o OpenRouter redireciona automaticamente pra outro que serve o mesmo modelo.

Criando Conta e API Key

  1. Acesse openrouter.ai e clique em 'Sign Up' — pode entrar com conta Google ou GitHub
  2. Vá em Settings > API Keys e clique em 'Create Key'
  3. Dê um nome descritivo pra chave (ex: 'dev-local', 'projeto-x') e copie o valor
  4. Para adicionar créditos: Settings > Credits > Add Credits (mínimo U$ 5)
  5. Sem créditos você ainda usa modelos gratuitos — tem um tier free com limite diário
  6. Guarde a key num arquivo .env.local — nunca commit ela no Git

Sistema de Creditos

Os créditos no OpenRouter funcionam como pré-pago: você carrega um valor em dólar e vai consumindo por token usado. O saldo não expira. Você pode ver em tempo real quanto cada request custou no dashboard de usage.

O tier gratuito existe pra modelos que os provedores oferecem sem custo — DeepSeek V3, Qwen Coder e alguns outros têm versões gratuitas no OpenRouter com limite de 50-200 requests por dia. Dá pra explorar bastante antes de colocar cartão de crédito.

Por que isso é importante

Integrando no Codigo

A integração é quase idêntica à API da OpenAI — só muda a URL base e você passa o nome do modelo no formato 'provedor/modelo'. Isso significa que se você já tem código usando a OpenAI SDK, a migração é literalmente 2 linhas.

typescript
import OpenAI from 'openai'

const openrouter = new OpenAI({
  baseURL: 'https://openrouter.ai/api/v1',
  apiKey: process.env.OPENROUTER_API_KEY,
  defaultHeaders: {
    'HTTP-Referer': 'https://seusite.com', // opcional, pra analytics
    'X-Title': 'Meu App', // opcional
  },
})

// Usar DeepSeek V3
const response = await openrouter.chat.completions.create({
  model: 'deepseek/deepseek-chat-v3-0324',
  messages: [{ role: 'user', content: 'Revise esse código TypeScript' }],
})

// Trocar pra Claude Sonnet: só muda o model
const response2 = await openrouter.chat.completions.create({
  model: 'anthropic/claude-sonnet-4-5',
  messages: [{ role: 'user', content: 'Revise esse código TypeScript' }],
})

Melhores Custo-Beneficio

Em março de 2026, os modelos com melhor relação qualidade-preço no OpenRouter são o DeepSeek V3 (U$ 0,27 por milhão de tokens de entrada, qualidade de código excelente) e o Qwen 2.5 Coder 72B (U$ 0,35/M, especializado em código). Pra comparar: o Claude Sonnet custa U$ 3/M e o GPT-4o U$ 2,5/M.

Pra tarefas que precisam de raciocínio profundo, o DeepSeek R1 é U$ 0,55/M — ainda muito abaixo dos modelos premium. Pra análise de documentos longos, o Gemini Flash 2.0 tem contexto de 1M tokens por U$ 0,075/M, o que é absurdamente barato pra esse volume.

OpenRouter vs APIs Diretas: Quando Usar Cada Um?

OpenRouter faz sentido quando você usa múltiplos modelos, quer trocar de modelo fácil, ou está explorando qual modelo funciona melhor pra seu caso de uso. API direta faz mais sentido quando você usa só um modelo em produção com volume alto e quer o menor custo possível — aqueles 5-10% de margem do OpenRouter acumulam em milhões de tokens.

Pra desenvolvimento e projetos pessoais, OpenRouter quase sempre vence. A conveniência de uma API key, um lugar pra ver o gasto e a facilidade de comparar modelos valem mais do que a margem que você paga. Pra produção com volume alto e modelo fixo, API direta.

Modelos Gratis Funcionam?

Sim, e bem. Os modelos marcados como ':free' no OpenRouter são versões sem custo dos modelos reais — não são versões reduzidas. O DeepSeek V3 free tier tem o mesmo modelo do pago, só com limite diário de requests. Pra uso pessoal e projetos pequenos, o free tier é suficiente.

A limitação real dos gratuitos é a velocidade: em horários de pico, você pode esperar 30-60 segundos por resposta no tier free. Colocar U$ 5 em crédito já muda a prioridade de fila e as respostas ficam muito mais rápidas.

Dicas Pra Gastar Menos

Checklist Final

  • Use modelos menores pra tarefas simples: Qwen 7B custa 10x menos que o 72B e resolve 70% dos casos
  • Ative caching de prompt quando seu system prompt é fixo — paga menos pela parte repetida
  • Monitore o dashboard de usage diariamente pra pegar gastos inesperados cedo
  • DeepSeek V3 free tier resolve a maioria das tarefas sem gastar crédito
  • Configure limite diário de gasto em Settings > Limits pra evitar surpresas
  • Compare modelos no playground do OpenRouter antes de integrar no código

O OpenRouter tem SLA garantido de disponibilidade?

Não tem SLA formal pra contas free. O plano pago tem mais garantias. Na prática, a disponibilidade é muito boa porque o OpenRouter faz fallback entre provedores — se a Anthropic tem uma queda, ele redireciona pra outro provedor do mesmo modelo se disponível. Mas pra produção crítica, vale ter um fallback próprio também.

Posso usar o OpenRouter com Python, não so TypeScript?

Sim. Como o OpenRouter segue o formato da OpenAI, qualquer cliente OpenAI funciona: Python com openai SDK, cURL, LangChain, LlamaIndex. Em Python é 'from openai import OpenAI' com a mesma mudança de baseURL. Funciona exatamente igual.

Pra usar os modelos disponíveis no OpenRouter diretamente dentro do seu editor de código, veja o guia de alternativas gratuitas ao Cursor AI — vários deles suportam configurar o OpenRouter como backend.

E se quiser montar um setup de vibe coding totalmente gratuito usando o OpenRouter como backbone, o artigo de vibe coding sem gastar nada tem o workflow completo do zero ao deploy.

Perguntas frequentes

O OpenRouter tem SLA garantido de disponibilidade?

Não tem SLA formal pra contas free. O plano pago tem mais garantias. Na prática, a disponibilidade é muito boa porque o OpenRouter faz fallback entre provedores — se a Anthropic tem uma queda, ele redireciona pra outro provedor do mesmo modelo se disponível. Mas pra produção crítica, vale ter um fallback próprio também.

Posso usar o OpenRouter com Python, não so TypeScript?

Sim. Como o OpenRouter segue o formato da OpenAI, qualquer cliente OpenAI funciona: Python com openai SDK, cURL, LangChain, LlamaIndex. Em Python é 'from openai import OpenAI' com a mesma mudança de baseURL. Funciona exatamente igual.