Skip to content

← Fundamentos

¿Qué es OpenRouter?

Una pasarela unificada que expone cientos de modelos de muchos proveedores tras un único endpoint compatible con OpenAI.

6 slides 4 min de lectura
  1. OpenRouter · Fonaments

    ¿Qué es OpenRouter?

    Una sola integración que llega a cientos de modelos.

    OpenRouter · Fundamentos arlaf.dev
  2. La definición corta

    OpenRouter es una pasarela — un agregador — que pone cientos de modelos de muchos proveedores tras una única API. Apuntas tu código a un solo endpoint y eliges el modelo con un slug.

    OpenRouter · Fundamentos arlaf.dev
  3. Compatible con OpenAI

    El truco es que habla el mismo dialecto que la API de OpenAI:

    • Mismo formato de petición chat/completions.
    • Puedes reaprovechar el SDK de OpenAI cambiando solo el base_url.
    • Una API key, una facturación por créditos.
    OpenRouter · Fundamentos arlaf.dev
  4. Apuntar el SDK de OpenAI a OpenRouter

    from openai import OpenAI
    
    # Mateix SDK; només canvia el base_url i la key
    client = OpenAI(
        base_url="https://openrouter.ai/api/v1",
        api_key="OPENROUTER_API_KEY",
    )
    
    resp = client.chat.completions.create(
        # El model va en forma proveïdor/model (exemple)
        model="anthropic/claude-3.5-sonnet",
        messages=[{"role": "user", "content": "Hola!"}],
    )
    print(resp.choices[0].message.content)
    
    OpenRouter · Fundamentos arlaf.dev
  5. Slugs proveedor/modelo

    Cada modelo se identifica con un slug en forma proveedor/modelo. Cambiar de modelo es cambiar una cadena de texto: openai/gpt-4o, meta-llama/llama-3.1-70b-instruct…

    OpenRouter · Fundamentos arlaf.dev
  6. Una integración, una key, una factura — y todo el catálogo de modelos a tu alcance.
    OpenRouter · Fundamentos arlaf.dev
Leer la nota completa

OpenRouter és, en una frase, una passarel·la unificada per a LLMs: un sol servei que exposa centenars de models de molts proveïdors diferents darrere d’una única API. En comptes d’integrar-te amb OpenAI per una banda, Anthropic per una altra i un proveïdor de Llama per una tercera, parles només amb OpenRouter i ell s’encarrega d’arribar a cadascun.

Un sol endpoint, compatible amb OpenAI

La peça clau és que OpenRouter és compatible amb l’API d’OpenAI. Parla el mateix dialecte de chat/completions, així que pots agafar l’SDK d’OpenAI que ja coneixes i fer-lo servir tal qual — només canvies el base_url perquè apunti a https://openrouter.ai/api/v1 i poses la teva key d’OpenRouter. El codi que tens escrit segueix funcionant.

Slugs proveïdor/model

Dins d’aquesta única API, cada model s’identifica amb un slug en forma proveïdor/model. Per exemple openai/gpt-4o, anthropic/claude-3.5-sonnet o meta-llama/llama-3.1-70b-instruct — tracta’ls com a exemples, perquè el catàleg es mou. El que importa és el patró: canviar de model és canviar una cadena de text, no reescriure la integració.

Per què una sola integració arriba a tants models

Quan tota la comunicació passa per un mateix endpoint i un mateix format, afegir un model nou no et costa codi nou. OpenRouter es col·loca al mig, tradueix la petició al proveïdor que toqui i et torna la resposta normalitzada. Tu segueixes fent la mateixa crida; només canvies l’slug.

Nota: el catàleg de models, els proveïdors disponibles i els seus noms exactes evolucionen contínuament. Tracta els slugs d’aquesta pàgina com a exemples i consulta la documentació actual d’OpenRouter per als noms vigents.