OpenRouter: Como Usar 150+ Modelos de IA

Se você programa com IA, já deve ter passado por essa situação: cria conta na OpenAI, gasta o crédito grátis em 3 dias, olha pro preço do GPT-4 e pensa 'preciso de alternativa'. Bem-vindo ao clube. E é exatamente aí que o OpenRouter entra.

Eu uso OpenRouter há meses e posso dizer que mudou completamente como eu consumo modelos de IA. Em vez de ficar preso a um provider, tenho acesso a mais de 150 modelos — e os grátis dão conta de 90% do que eu preciso no dia a dia pra programar.

O que é o OpenRouter

OpenRouter é um agregador de modelos de IA. Funciona como um proxy: você faz uma requisição pra API deles e eles roteiam pro modelo que você escolheu. A API é compatível com o formato da OpenAI, então qualquer ferramenta que funciona com a OpenAI funciona com o OpenRouter — só trocar a base URL.

A sacada é que eles juntam modelos de vários providers num lugar só. Google (Gemini), Meta (Llama), DeepSeek, Mistral, Anthropic, Qwen — tudo acessível com uma única API key. E o melhor: vários desses modelos têm tier grátis.

Criando conta e pegando sua API key

Melhores modelos grátis pra código

Galera, aqui é onde o OpenRouter brilha de verdade. Vou listar os modelos grátis que eu mais uso pra programar, com a pegada de cada um.

Geração de código

Code review e debugging

Integrando com IDEs

Cursor

O Cursor aceita qualquer API compatível com OpenAI. A configuração é direta:

// Settings do Cursor → Models → OpenAI API Key
{
  "openai.apiKey": "sk-or-v1-SUA_KEY_AQUI",
  "openai.baseUrl": "https://openrouter.ai/api/v1"
}
// Depois vá em Model e digite o ID do modelo:
// deepseek/deepseek-chat-v3-0324:free
// qwen/qwen-2.5-coder-32b-instruct:free

Com isso, todos os modelos grátis do OpenRouter ficam disponíveis no Cursor. Você pode trocar de modelo sem reconfigurar nada — só muda o ID na hora de usar.

Continue (VS Code)

O Continue tem suporte nativo ao OpenRouter. Edite o arquivo config.json:

{
  "models": [
    {
      "title": "DeepSeek V3 (Free)",
      "provider": "openrouter",
      "model": "deepseek/deepseek-chat-v3-0324:free",
      "apiKey": "sk-or-v1-SUA_KEY_AQUI"
    },
    {
      "title": "Qwen Coder (Free)",
      "provider": "openrouter",
      "model": "qwen/qwen-2.5-coder-32b-instruct:free",
      "apiKey": "sk-or-v1-SUA_KEY_AQUI"
    }
  ]
}

OpenCode (Terminal)

O OpenCode funciona direto no terminal e aceita OpenRouter via variável de ambiente:

# Instalar OpenCode
npm install -g @anthropics/opencode

# Configurar com OpenRouter
export OPENROUTER_API_KEY="sk-or-v1-SUA_KEY_AQUI"

# Rodar com modelo específico
opencode --provider openrouter --model deepseek/deepseek-chat-v3-0324:free

Maximizando o uso grátis

Os modelos grátis do OpenRouter têm rate limits. Não é ilimitado — mas com algumas estratégias dá pra esticar bastante o uso diário.

OpenRouter vs API direta — quando usar cada um

Na prática, o setup ideal é OpenRouter pra desenvolvimento e experimentação (onde você troca de modelo toda hora) e API direta pra produção (onde precisa de latência mínima e SLA). Dá pra usar os dois ao mesmo tempo sem problema.

Exemplo prático: chamada via código

Se você quer integrar o OpenRouter direto no seu app (não só via IDE), a API é compatível com a da OpenAI. Olha como fica em TypeScript:

import OpenAI from 'openai';

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

async function gerarCodigo(prompt: string) {
  const response = await openrouter.chat.completions.create({
    model: 'deepseek/deepseek-chat-v3-0324:free',
    messages: [
      { role: 'system', content: 'Você é um dev senior. Gere código limpo e bem comentado.' },
      { role: 'user', content: prompt }
    ],
    temperature: 0.3 // mais baixo = código mais consistente
  });
  return response.choices[0].message.content;
}

Percebeu? É a mesma SDK da OpenAI. Só muda a baseURL e a apiKey. Se você já tem código que usa OpenAI, migrar pra OpenRouter é trocar duas linhas. Simples assim.

FAQ — Perguntas frequentes

O OpenRouter é realmente grátis?

Sim, vários modelos têm tier grátis com rate limits. Pra uso pessoal e desenvolvimento, os limites são suficientes na maioria dos casos. Modelos premium cobram por token, mas você escolhe quais usar.

Quais são os melhores modelos grátis pra código?

DeepSeek V3 pra geração, Qwen 2.5 Coder pra completar e refatorar, Gemini Flash pra review de código grande e DeepSeek R1 pra debugging de lógica complexa. Essa combinação cobre praticamente tudo.

Dá pra usar OpenRouter no Cursor?

Dá sim. Configure a base URL como https://openrouter.ai/api/v1 e coloque sua API key nas settings. Todos os modelos grátis ficam disponíveis direto na interface.

OpenRouter vs usar a API direta — qual é melhor?

Depende do uso. OpenRouter é melhor pra flexibilidade e experimentação com vários modelos. API direta é melhor pra produção onde latência e SLA importam. O ideal é combinar os dois.