Skip to content

← Models and routing

The model catalog

Hundreds of models from many providers behind one API. How they're named, who serves them and how you list them.

6 slides 5 min read
  1. OpenRouter · Models i routing

    The model catalog

    Hundreds of models from many providers, one identifier.

    OpenRouter · Models and routing arlaf.dev
  2. The slug shape

    Each model is identified by a "provider/model" slug. You pick a model by passing that string in the request's "model" field, just like you would with OpenAI's API.

    • openai/gpt-4o
    • anthropic/claude-3.5-sonnet
    • meta-llama/llama-3.1-70b-instruct
    OpenRouter · Models and routing arlaf.dev
  3. One model, several providers

    The same open-weight model can be served by several backends at once. OpenRouter unifies them under one slug and picks one for you, unless you say otherwise.

    OpenRouter · Models and routing arlaf.dev
  4. The auto-router

    If you'd rather not decide, the "openrouter/auto" slug lets OpenRouter pick a suitable model from the prompt. Handy for testing; for production you usually want to pin it.

    OpenRouter · Models and routing arlaf.dev
  5. Tag variants and the listing

    # Variants d'un mateix slug (exemples, verifica'ls als docs):
    #   anthropic/claude-3.5-sonnet:beta
    #   meta-llama/llama-3.1-70b-instruct:free
    #   meta-llama/llama-3.1-70b-instruct:nitro    # throughput
    #   meta-llama/llama-3.1-70b-instruct:floor     # el més barat
    
    # Llistar tot el catàleg amb metadades de cada model:
    curl https://openrouter.ai/api/v1/models
    
    OpenRouter · Models and routing arlaf.dev
  6. One endpoint, one slug — and hundreds of models behind it.
    OpenRouter · Models and routing arlaf.dev
Read the full note

OpenRouter exposa centenars de models de molts proveïdors darrere d’una sola API compatible amb OpenAI. No canvies de SDK ni de URL per saltar d’un model a un altre: només canvies un text. Aquest text és el slug del model.

La forma del slug

Tot model s’identifica amb la forma proveïdor/model — per exemple openai/gpt-4o, anthropic/claude-3.5-sonnet o meta-llama/llama-3.1-70b-instruct. El passes al camp model de la petició i ja està: la part de l’esquerra diu de quina família ve i la de la dreta, quin model concret vols.

El mateix model, diversos proveïdors

Aquí hi ha un matís important. Un model open-weight com Llama pot estar allotjat per diversos backends alhora, cadascun amb el seu preu, latència i límits. OpenRouter els amaga tots sota un únic slug i en tria un per tu quan fas la crida — més endavant veuràs com forçar-ne un de concret.

L’auto-router

Si no vols ni triar el model, el slug openrouter/auto deixa que OpenRouter seleccioni un model raonable a partir del prompt. Va bé per fer proves ràpides; en producció, però, normalment voldràs fixar el model perquè el comportament sigui previsible.

Variants amb tag

Sobre un slug pots afegir un tag amb : per demanar una variant. Alguns exemples que circulen són :free (versions gratuïtes amb límits), :nitro (prioritza throughput) o :floor (prioritza el preu més baix).

Nota: els noms exactes dels tags i el seu comportament canvien. Tracta’ls com a exemples i confirma’ls sempre a la documentació vigent d’OpenRouter.

Llistar el catàleg

Per saber què tens disponible en cada moment, l’endpoint GET /models retorna la llista completa amb metadades de cada model. És la font de veritat per descobrir slugs, variants i proveïdors sense haver-los de memoritzar.