Skip to content

← Fonaments

Què és OpenRouter?

Una passarel·la unificada que exposa centenars de models de molts proveïdors darrere d'un sol endpoint compatible amb OpenAI.

6 slides 4 min de lectura
  1. OpenRouter · Fonaments

    Què és OpenRouter?

    Una sola integració que arriba a centenars de models.

    OpenRouter · Fonaments arlaf.dev
  2. La definició curta

    OpenRouter és una passarel·la — un agregador — que posa centenars de models de molts proveïdors darrere d'una única API. Apuntes el teu codi a un sol endpoint i tries el model amb un slug.

    OpenRouter · Fonaments arlaf.dev
  3. Compatible amb OpenAI

    El truc és que parla el mateix dialecte que l'API d'OpenAI:

    • Mateix format de petició chat/completions.
    • Pots reaprofitar l'SDK d'OpenAI canviant només el base_url.
    • Una API key, una facturació per crèdits.
    OpenRouter · Fonaments arlaf.dev
  4. Apuntar l'SDK d'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 · Fonaments arlaf.dev
  5. Slugs proveïdor/model

    Cada model s'identifica amb un slug en forma proveïdor/model. Canviar de model és canviar una cadena de text: openai/gpt-4o, meta-llama/llama-3.1-70b-instruct…

    OpenRouter · Fonaments arlaf.dev
  6. Una integració, una key, una factura — i tot el catàleg de models al teu abast.
    OpenRouter · Fonaments arlaf.dev
Llegir 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.