Pular para o conteúdo
Tutoriais

OpenRouter: Como Acessar GPT-4, Claude

Uma API key. 200+ modelos. Troca de modelo mudando uma string. OpenRouter e o canivete suico pra quem nao quer ficar preso num unico provider.

Uma API pra tudo

O problema e conhecido: voce quer usar Claude pra coding, GPT-4 pra analise de dados e Gemini pra processar documentos longos. Pra fazer isso direto, voce precisa de conta na Anthropic, na OpenAI e no Google AI Studio. Tres API keys diferentes, tres sistemas de billing, tres dashboards pra monitorar.

OpenRouter resolve isso com uma camada unica de acesso. Voce cria uma conta, gera uma API key, e usa essa mesma key pra acessar qualquer modelo de qualquer provider. A URL base e sempre a mesma — voce so muda o campo model no request. E o formato da API e compativel com OpenAI, entao qualquer ferramenta que funciona com a OpenAI funciona com OpenRouter trocando a base URL.

Pra dev que usa ferramentas como Aider, OpenCode ou Continue.dev, isso e perfeito. Voce configura o OpenRouter uma vez e tem acesso a todos os modelos do mercado. Quer testar se o Claude Sonnet resolve melhor que o GPT-4o pra um caso especifico? Muda uma string e testa.

Setup OpenRouter

O setup leva menos de 5 minutos. Nao tem CLI pra instalar, nao tem SDK obrigatorio — e uma API REST padrao.

  1. Criar conta
    Acesse openrouter.ai e crie uma conta. Pode usar login com Google ou GitHub. Sem cartao de credito obrigatorio — tem creditos gratis pra comecar e modelos totalmente gratis.
  2. Gerar API key
    No dashboard, va em Keys e crie uma nova key. Copie e guarde num lugar seguro. Essa e a unica key que voce vai precisar pra tudo.
  3. Adicionar creditos (opcional)
    Se voce quer usar modelos pagos como Claude ou GPT-4, adicione creditos. O minimo e $5. Mas varios modelos sao gratis — da pra comecar sem gastar nada.
  4. Testar com curl
    Rode o comando abaixo pra confirmar que ta funcionando. Se retornar uma resposta do modelo, ta tudo certo.
bash
# Testar OpenRouter com curl
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer sk-or-v1-SUA_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "messages": [
      {"role": "user", "content": "Diga oi em portugues"}
    ]
  }'

# Trocar modelo: so muda o campo "model"
# GPT-4o: "openai/gpt-4o"
# Gemini: "google/gemini-2.0-flash"
# Llama 3.1 (gratis): "meta-llama/llama-3.1-8b-instruct:free"

Percebeu? A URL base e sempre openrouter.ai/api/v1 e o formato e identico ao da API da OpenAI. Qualquer biblioteca ou ferramenta que aceita a OpenAI API funciona com OpenRouter trocando a base URL e a key.

Precificacao

OpenRouter cobra por token, igual aos providers originais. Na maioria dos modelos, o preco e identico ou muito proximo do preco direto. Em alguns casos, o OpenRouter consegue preco melhor por volume. Voce nunca paga mais do que pagaria direto.

O modelo de billing e pre-pago: voce adiciona creditos e vai usando. Sem surpresa no cartao. Quando os creditos acabam, para de funcionar — sem divida, sem cobranca retroativa. Pra quem tem trauma de billing cloud, isso e um alivio.

Modelos Gratis

+ Prós

  • • Llama 3.1 8B, Gemma 2, Mistral 7B disponiveis gratis
  • • Sem limite rigido de requests (rate limit generoso)
  • • Bom pra autocomplete e tarefas leves de coding
  • • Ideal pra aprender e experimentar sem risco

− Contras

  • • Modelos menores, menos capacidade que os pagos
  • • Pode ter fila em horarios de pico
  • • Nao recomendado pra producao ou tarefas criticas

Modelos Pagos Baratos ($0.10-1/M tokens)

+ Prós

  • • Gemini 2.0 Flash, Claude Haiku, GPT-4o Mini
  • • Custo baixissimo: ~R$0.50 por sessao de coding
  • • Performance excelente pra maioria das tarefas
  • • Melhor custo-beneficio do mercado

− Contras

  • • Menos potentes que os modelos premium
  • • Context window menor em alguns casos
  • • Podem alucinar mais em tarefas muito complexas

Modelos Premium ($3-15/M tokens)

+ Prós

  • • Claude Sonnet/Opus, GPT-4o, Gemini Ultra
  • • Melhor qualidade de codigo e raciocinio
  • • Context window enorme (200k+ tokens)
  • • Ideal pra refatoracao pesada e arquitetura

− Contras

  • • Custo significativo em uso intenso
  • • Uma sessao longa pode custar R$5-15
  • • Nem sempre a diferenca justifica o preco

Na pratica, a maioria dos devs gasta entre $5 e $20 por mes usando OpenRouter com um mix de modelos baratos pra dia a dia e premium pra tarefas complexas. Bem menos que a assinatura mensal de qualquer IDE com IA.

Integrando com ferramentas

A integracao com ferramentas de AI coding e direta. Como o OpenRouter segue o formato da API da OpenAI, voce so precisa mudar duas coisas: a base URL e a API key.

Com Aider

bash
# Configurar Aider com OpenRouter
export OPENROUTER_API_KEY=sk-or-v1-sua-key
aider --model openrouter/anthropic/claude-sonnet-4

# Trocar modelo no meio da sessao: /model openrouter/openai/gpt-4o

Com OpenCode

bash
# Configurar OpenCode com OpenRouter
opencode config set provider openrouter
opencode config set api-key sk-or-v1-sua-key
opencode config set model anthropic/claude-sonnet-4

Com Continue.dev

json
// ~/.continue/config.json
{
  "models": [
    {
      "title": "Claude Sonnet via OpenRouter",
      "provider": "openrouter",
      "model": "anthropic/claude-sonnet-4",
      "apiKey": "sk-or-v1-sua-key"
    },
    {
      "title": "GPT-4o via OpenRouter",
      "provider": "openrouter",
      "model": "openai/gpt-4o",
      "apiKey": "sk-or-v1-sua-key"
    }
  ]
}

Na sua propria aplicacao

typescript
// Usando o SDK da OpenAI com OpenRouter
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://openrouter.ai/api/v1',
  apiKey: process.env.OPENROUTER_API_KEY,
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-4',
  messages: [{ role: 'user', content: 'Refatore essa funcao...' }],
});

console.log(response.choices[0].message.content);

Sacou? Voce usa o SDK oficial da OpenAI, troca a baseURL pra openrouter.ai e pronto. Qualquer tutorial ou biblioteca que funciona com a OpenAI funciona com OpenRouter com essa unica mudanca.

Dicas de economia

Gastar pouco com OpenRouter nao e sobre usar menos — e sobre usar o modelo certo pra cada tarefa. Nao faz sentido mandar autocomplete pro Claude Opus a $15/M tokens quando o Llama 3.1 gratis resolve igual.

Estrategias pra gastar menos

  • Use modelos gratis (Llama, Gemma) pra autocomplete e tarefas simples
  • Reserve modelos premium (Claude, GPT-4o) pra refatoracao e arquitetura
  • Configure modelos diferentes por funcao no Continue.dev (chat vs autocomplete)
  • Monitore seu gasto no dashboard do OpenRouter — tem graficos por modelo
  • Defina um limite de gasto mensal nas configuracoes da conta
  • Combine com Ollama local: use local pra coisas leves, OpenRouter pra pesado

A combinacao matadora e: Ollama local pra autocomplete e perguntas rapidas (custo zero), OpenRouter com modelo barato pra tarefas medias (centavos), e OpenRouter com Claude/GPT-4o pra coisas que precisam de qualidade maxima (poucos reais). Essa estrategia em camadas mantem o gasto mensal abaixo de R$30 na maioria dos casos.

Junte tudo num setup completo

OpenRouter e uma peca do quebra-cabeca. Combine com Ollama pra rodar modelos locais e com as ferramentas do comparativo IAs Gratis no Terminal pra ter um setup profissional de AI coding. Veja o tutorial Setup de AI Coding 100% Gratis pra montar tudo do zero.