De OpenRouter a un gateway con garantías de primera parte: la migración honesta

Empecemos por lo justo: OpenRouter es el líder en amplitud. Una clave, una URL base, y llegas a más de 300 modelos — incluida la larga cola de código abierto (Llama, Qwen, DeepSeek, Mistral y decenas de fine-tunes de la comunidad) que ninguna API de primera parte expone. Si tu trabajo es evaluar un campo amplio, sortear caídas entre proveedores o alcanzar un modelo de pesos abiertos de nicho, ese catálogo es una ventaja genuina y difícil de replicar. Este artículo no es un ataque.

Es una guía de cuándo encaja cada uno. Hay un conjunto distinto de tareas — aquellas en las que quieres el modelo insignia genuino de primera parte con sus funciones nativas intactas, una facturación que puedes auditar token a token, imagen y vídeo en la misma clave, y un descuento por modelo lo bastante pequeño como para ser real. Ahí es donde los equipos añaden un gateway con garantías de primera parte como Brievio junto a OpenRouter, o trasladan a él toda la ruta de producción. La migración en sí es un cambio de una línea en base_url más renombrar los slugs de modelo. Aquí está la decisión honesta y la mecánica.

Cuándo OpenRouter es la decisión correcta

Ten esto claro antes de cambiar nada. OpenRouter encaja mejor cuando:

• Necesitas la larga cola de código abierto. Llama, Qwen, DeepSeek, Mistral y los fine-tunes de la comunidad no están en ninguna API de primera parte. Si tu hoja de ruta toca modelos de pesos abiertos, quieres ese catálogo.
• Estás corriendo una evaluación amplia. Comparar veinte modelos de cinco proveedores es justo para lo que se construyó un agregador de 300 modelos. Una clave, un esquema, todos los modelos.
• Quieres el failover entre proveedores como funcionalidad. OpenRouter puede recurrir a otros proveedores upstream para un modelo dado. Para ciertos perfiles de disponibilidad, esa amplitud de enrutamiento es justo el objetivo.
• Estás buscando el host más barato de un modelo abierto dado. El marketplace muestra varios proveedores por modelo y te deja ordenarlos por precio. Esa es una palanca real.

Nada de eso desaparece por añadir Brievio. Muchos equipos conservan OpenRouter para exactamente estas tareas y solo dirigen a otro sitio el tráfico de producción de primera parte. Dos URLs base, un solo código.

Cuándo encaja mejor un gateway con garantías de primera parte

El argumento para cambiar (o repartir el tráfico) es más estrecho y específico. Recurre a él cuando estos puntos importen:

• Necesitas el modelo genuino de primera parte, con sus funciones nativas intactas. No un fine-tune ni un casi-equivalente — el Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 y Gemini 2.5 Pro / Flash de verdad, con uso de tools nativo, visión y caché de prompts funcionando como los documenta el proveedor. Cuando el comportamiento de un modelo insignia es tu producto, «lo bastante cercano» no basta.
• Quieres una facturación de tokens honesta que puedas auditar. Tu coste real es tarifa × tokens, y el conteo de tokens es la cifra más fácil de inflar. Brievio reporta conteos de tokens genuinos de primera parte y los factura tal cual. Si nunca lo has comprobado, es una autoprueba de veinte líneas.
• Quieres imagen y vídeo en la misma clave. Nano Banana y Nano Banana Pro, GPT-Image-2 y Veo 3 están detrás de las mismas credenciales y el mismo cliente con forma de OpenAI que tus modelos de chat — sin una segunda cuenta de proveedor, sin una superficie de facturación aparte.
• Quieres un descuento lo bastante pequeño como para fiarte. Los modelos de chat van alrededor de un 15% por debajo de la lista oficial, imagen y vídeo en torno a un 37,5% por debajo, publicado por modelo frente a la tarifa de referencia oficial para que puedas auditar el margen. Un descuento modesto y explicable es un margen sobre el volumen — no un subsidio que haya que recuperar en algún sitio que no puedas ver.
• Las llamadas fallidas son gratis. Las respuestas 4xx y 5xx no se facturan, así que un mal día de un upstream no se convierte calladamente en una línea de tu factura.

La migración: un base_url, una clave

Como ambos gateways implementan la API de OpenAI Chat Completions, el cambio es el diff más pequeño de tu código. Apuntas el SDK a un host nuevo y cambias la clave. El streaming, las llamadas a funciones, el modo JSON y la forma de tus peticiones quedan intactos:

# Migrar fuera de OpenRouter es un diff de dos líneas: cambia el base_url y la clave.
# Todo lo demás — el SDK de OpenAI, la forma de tus peticiones, el streaming, las tools —
# se queda exactamente igual, porque ambos hablan la API de OpenAI Chat Completions.

from openai import OpenAI

# --- Antes: OpenRouter ---
client = OpenAI(
    api_key="sk-or-...",
    base_url="https://openrouter.ai/api/v1",
)

# --- Después: Brievio ---
client = OpenAI(
    api_key="sk-brievio-...",
    base_url="https://api.brievio.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",                 # ver la correspondencia de nombres abajo
    messages=[{"role": "user", "content": "Summarize this contract clause…"}],
)

Si en su día llegaste a OpenRouter desde el SDK oficial de OpenAI, esto te sonará familiar — es el mismo movimiento que nuestra migración de diez minutos desde OpenAI, solo que con un origen distinto. Sin SDK nuevo, sin reescribir tus puntos de llamada.

Lo único que cambias: los slugs de modelo

Esta es la única diferencia de comportamiento que merece unos minutos de cuidado. OpenRouter pone a cada modelo en un espacio de nombres vendor/model — anthropic/claude-sonnet-4.6, google/gemini-2.5-flash — porque con más de 300 modelos de muchos proveedores, ese espacio de nombres evita colisiones. Brievio sirve un conjunto curado de primera parte, así que los slugs son simples: claude-sonnet-4-6, gemini-2.5-flash. Sin prefijo vendor/.

# Lo único que SÍ tocas: los slugs de modelo.
# OpenRouter pone a cada modelo en un espacio de nombres "vendor/model" para que
# 300+ modelos de muchos proveedores nunca colisionen. Brievio sirve un conjunto
# curado de primera parte, así que los slugs son simples — sin prefijo "vendor/".

MODEL_MAP = {
    # slug de OpenRouter              ->  slug de Brievio
    "anthropic/claude-opus-4.7":         "claude-opus-4-7",
    "anthropic/claude-sonnet-4.6":       "claude-sonnet-4-6",
    "anthropic/claude-haiku-4.5":        "claude-haiku-4-5",
    "google/gemini-2.5-pro":             "gemini-2.5-pro",
    "google/gemini-2.5-flash":           "gemini-2.5-flash",
    # Imagen + vídeo viven en la MISMA clave — sin cuenta de proveedor aparte:
    # "nano-banana", "nano-banana-pro", "gpt-image-2", "veo-3"
}

def to_brievio(slug: str) -> str:
    return MODEL_MAP.get(slug, slug.split("/")[-1])

# Atajo pragmático para Claude/Gemini: quita el prefijo y pasa la versión de
# punto a guion. "anthropic/claude-sonnet-4.6" -> "claude-sonnet-4-6". Confirma
# cada uno contra /models para fallar a gritos ante una errata en vez de enrutar mal en silencio.

Para Claude y Gemini la regla es mecánica: quita el prefijo y escribe la versión con guiones en vez de un punto (4.6 → 4-6). Mantén un pequeño diccionario de correspondencias en lugar de manipular cadenas a ciegas, y valida cada slug contra la lista de modelos para que una errata falle a gritos al arrancar en vez de enrutar en silencio al lugar equivocado. Este es el único buscar-y-reemplazar que la migración realmente exige.

Un despliegue pragmático

No tienes que elegir todo de golpe. El camino de menor riesgo trata a los dos gateways como complementos:

• Hazlos correr en paralelo. Mantén OpenRouter apuntando a la larga cola de código abierto y a tu arnés de evaluación. Añade Brievio como un segundo cliente para los modelos insignia de primera parte en tu ruta de producción. Dos URLs base, un solo repositorio.
• Haz shadow antes de migrar del todo. Refleja una porción del tráfico en vivo hacia Brievio y compara las respuestas y los objetos usage. Estás comprobando que el modelo es el genuino de primera parte y que los conteos de tokens cuadran con lo que esperas — la autoprueba de tokens es exactamente esta comprobación, automatizada.
• Mueve primero el trabajo multimodal. Si hoy estás cosiendo un proveedor de imagen o vídeo aparte, consolidar Nano Banana / GPT-Image-2 / Veo 3 en una sola clave suele ser la victoria temprana más limpia — menos cuentas, una sola factura, una sola ruta de autenticación.
• Promociona cuando el diff sea aburrido. Una vez que el tráfico en shadow coincida y los números cuadren, cambia el valor por defecto de producción. Haz rollback revirtiendo un solo base_url si algo te sorprende.

La conclusión honesta

OpenRouter y un gateway con garantías de primera parte no compiten en realidad por la misma tarea. OpenRouter optimiza para el alcance — el catálogo más amplio y la larga cola de código abierto bajo una sola clave, que es algo real y valioso. Brievio optimiza para la fidelidad sobre un conjunto curado — los modelos insignia genuinos de primera parte con sus funciones nativas intactas, una facturación de tokens honesta y auditable, imagen y vídeo en la misma clave, y un descuento por modelo lo bastante pequeño como para fiarse. Ambos están detrás de un único base_url compatible con OpenAI, que es precisamente por lo que tantos equipos usan ambos: amplitud donde necesitan amplitud, fidelidad donde cuenta.

Si quieres los modelos genuinos de primera parte con su comportamiento nativo y una facturación que puedas verificar, el movimiento te cuesta un base_url, una clave y renombrar los slugs de modelo. Lee la comparación lado a lado en Brievio frente a OpenRouter, revisa los modelos y slugs exactos en la lista de modelos y corre la autoprueba de tokens contra ambos antes de poner tráfico real en cualquier sitio. La decisión sobrevive al escrutinio en cualquier caso — que es el único tipo de decisión que vale la pena enviar a producción.