Skip to content

← Foundations

What is OpenRouter?

A unified gateway exposing hundreds of models from many providers behind one OpenAI-compatible endpoint.

6 slides 4 min read
  1. OpenRouter · Fonaments

    What is OpenRouter?

    One integration that reaches hundreds of models.

    OpenRouter · Foundations arlaf.dev
  2. The short definition

    OpenRouter is a gateway — an aggregator — that puts hundreds of models from many providers behind a single API. You point your code at one endpoint and pick the model with a slug.

    OpenRouter · Foundations arlaf.dev
  3. OpenAI-compatible

    The trick is it speaks the same dialect as the OpenAI API:

    • Same chat/completions request shape.
    • Reuse the OpenAI SDK by only changing base_url.
    • One API key, one credit-based bill.
    OpenRouter · Foundations arlaf.dev
  4. Point the OpenAI SDK at 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 · Foundations arlaf.dev
  5. Provider/model slugs

    Each model is identified by a provider/model slug. Switching models is switching a string: openai/gpt-4o, meta-llama/llama-3.1-70b-instruct…

    OpenRouter · Foundations arlaf.dev
  6. One integration, one key, one bill — and the whole model catalog within reach.
    OpenRouter · Foundations arlaf.dev
Read the full note

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.