Compatibilidad con la API de OpenAI

OpenRouter habla el esquema de chat-completions de OpenAI, así que reaprovechas el SDK oficial cambiando solo base_url y api_key.

1 de junio de 2026 6 slides 4 min de lectura

OpenRouter · Integració

Compatibilidad con la API de OpenAI

Cientos de modelos detrás de un endpoint que ya sabes usar.
La idea en una frase

OpenRouter expone el esquema de chat-completions de OpenAI. Si tu código ya habla con OpenAI, solo tienes que reapuntar adónde apunta.
- base_url → https://openrouter.ai/api/v1
- api_key → tu clave de OpenRouter
- model → un slug del catálogo, p. ej. openai/gpt-4o
OpenRouter · Integración arlaf.dev

Mismo SDK, en Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.environ["OPENROUTER_API_KEY"],
)

resp = client.chat.completions.create(
    model="anthropic/claude-3.5-sonnet",  # slug del catàleg (exemple)
    messages=[{"role": "user", "content": "Hola, qui ets?"}],
)
print(resp.choices[0].message.content)

Lo mismo, en TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "openai/gpt-4o", // slug del catàleg (exemple)
  messages: [{ role: "user", content: "Hola, qui ets?" }],
});
console.log(resp.choices[0].message.content);

Los frameworks también encajan

Cualquier librería construida sobre la API de OpenAI — LangChain, el Vercel AI SDK, LlamaIndex — funciona reapuntando la base URL y la clave. No reescribes nada.
Cambias dos líneas de configuración, no el cliente entero.

Leer la nota completa

La gràcia d’OpenRouter és que no t’obliga a aprendre una API nova. Parla exactament l’esquema de chat-completions d’OpenAI, el mateix que ja fan servir mig món i totes les llibreries serioses de l’ecosistema. Per tant, el codi que ja tens contra OpenAI segueix valent — només cal redirigir-lo.

Què canvia, exactament

Tres coses i prou:

base_url: apunta a https://openrouter.ai/api/v1 en comptes de l’endpoint d’OpenAI.
api_key: la teva clau d’OpenRouter, normalment des d’una variable d’entorn com OPENROUTER_API_KEY — mai escrita al codi.
model: un slug del catàleg, com openai/gpt-4o o anthropic/claude-3.5-sonnet. Aquí és on tries entre centenars de models de proveïdors diferents, tots darrere del mateix endpoint.

La forma de les peticions i les respostes — messages, choices, message.content — és idèntica. Per això pots fer servir l’SDK oficial d’OpenAI tant en Python com en JS/TS sense tocar res més.

Els frameworks t’ho regalen

Com que tot l’ecosistema s’ha construït sobre aquest esquema, eines com LangChain, el Vercel AI SDK o LlamaIndex s’integren igual: la majoria exposen un paràmetre per fixar la base URL i la clau. El canvi és de configuració, no de codi.

Nota: els slugs de model són exemples. Mira el catàleg d’OpenRouter per saber quins models hi ha disponibles i com s’anomenen exactament en cada moment.