OpenRouter

OpenRouter: Tu puerta de entrada a todos los modelos

OpenRouter es el enrutador de IA más popular y completo. Con una sola API key, accedes a más de 300 modelos de más de 50 proveedores, incluyendo modelos completamente gratuitos.

¿Qué es OpenRouter?

OpenRouter es un servicio que unifica el acceso a modelos de IA de diferentes proveedores bajo una sola API compatible con el formato de OpenAI. Piensa en ello como el “Skyscanner de los modelos de IA”: busca, compara y enruta tu solicitud al mejor modelo disponible.

Crear una cuenta

1. Ve a openrouter.ai
2. Clic en “Sign In” (Google, GitHub, o email)
3. Sin tarjeta de crédito para empezar
4. Genera tu API key en Settings → API Keys
5. Listo — ya puedes hacer llamadas

Modelos gratuitos

[!IMPORTANT] OpenRouter ofrece modelos completamente gratuitos. No consumen tu saldo. Solo tienen rate limits.

Modelo	Proveedor	Context	Rate Limit	Mejor para
google/gemini-2.0-flash-exp:free	Google	1M+	20/min	General, rápido
meta-llama/llama-4-maverick:free	Meta	128K	20/min	Open source, customizable
deepseek/deepseek-chat:free	DeepSeek	128K	20/min	Razonamiento, código
deepseek/deepseek-r1:free	DeepSeek	128K	10/min	Razcionamiento profundo
mistralai/mistral-small-3.1:free	Mistral	128K	20/min	Multilingual, EU compliance
qwen/qwen3-235b-a22b:free	Alibaba	128K	20/min	Multilingual, código

Usando OpenRouter

curl

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.0-flash-exp:free",
    "messages": [
      {"role": "user", "content": "Explica la fotosíntesis en español, en 3 bullets"}
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="TU_OPENROUTER_API_KEY"
)

response = client.chat.completions.create(
    model="google/gemini-2.0-flash-exp:free",
    messages=[
        {"role": "user", "content": "Escribe un poema sobre la luna en español"}
    ]
)
print(response.choices[0].message.content)

Node.js

import OpenAI from 'openai';

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

const completion = await openai.chat.completions.create({
  model: 'google/gemini-2.0-flash-exp:free',
  messages: [{ role: 'user', content: 'Hola, ¿me ayudas?' }],
});
console.log(completion.choices[0].message.content);

Fallbacks: Siempre funciona

OpenRouter permite configurar fallbacks automáticos:

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",          # Intenta Claude primero
    fallbacks=["openai/gpt-4o-mini", "google/gemini-2.0-flash-exp:free"],  # Si falla
    messages=[{"role": "user", "content": "Hola"}]
)

Si Claude está caído o excedes el rate limit, OpenRouter automáticamente prueba GPT-4o-mini, y si ese también falla, Gemini Flash gratis.

Routing inteligente

Puedes hacer que OpenRouter elija el mejor modelo automáticamente:

# Auto-routing: OpenRouter elige el mejor modelo para tu uso
response = client.chat.completions.create(
    model="openrouter/auto",  # Routing automático
    messages=[{"role": "user", "content": "Resuelve esta integral..."}]
)

Pricing de modelos de pago

Modelo	Input (1M tokens)	Output (1M tokens)	Nota
GPT-4o	$2.50	$10.00	Flagship OpenAI
GPT-4o-mini	$0.15	$0.60	Mejor relación calidad/precio
Claude Sonnet 4	$3.00	$15.00	Escritura y código
Gemini 2.5 Pro	$1.25	$10.00	Documentos largos
DeepSeek V3	$0.14	$0.28	Más barato con buena calidad

[!TIP] Para uso personal/aprendizaje: usa solo modelos gratuitos. Para producción: GPT-4o-mini o DeepSeek V3 son los más económicos con buena calidad.

Lo mejor y lo peor

Lo mejor

• Modelos gratuitos reales: No necesitas card para empezar
• API unificada: Un formato, 300+ modelos
• Fallbacks: Tu app nunca se queda sin modelo
• Transparencia: Ves pricing de cada modelo antes de usarlo
• Sin lock-in: Cambias de modelo cambiando un string

Lo peor

• Latencia extra: ~50-200ms vs API directa
• Markup: Pequeño sobreprecio en modelos de pago
• Rate limits modelos gratis: Limitados pero funcionales
• No reemplaza la interfaz web: Es API, no chat UI

En el próximo capítulo exploramos NanoBanana, una alternativa más simple para quienes solo necesitan los modelos más populares.