OpenRouter: una API unificada para varios modelos de IA

OpenRouter ofrece a los desarrolladores un catálogo común y una capa de API para elegir distintos modelos y proveedores de IA. Su sitio muestra modelos de texto, imagen, vídeo y audio, además de opciones de integración mediante API, SDK de cliente y Agent SDK. Las capacidades, precios, límites de contexto, disponibilidad regional y políticas de cada proveedor son diferentes. Antes de integrar, consulta el catálogo de modelos, la documentación oficial y la página de precios.

Funciones principales

• API y catálogo unificados: consulta y llama a los modelos disponibles mediante una API. El catálogo muestra descripciones y precios vigentes; también puedes obtener la lista de modelos mediante API.
• Compatibilidad con OpenAI SDK: la documentación oficial ofrece una vía de integración. La migración aún requiere configurar la URL base de OpenRouter, la clave y el identificador del modelo, y comprobar que admite los parámetros necesarios.
• SDK de cliente y Agent SDK: hay SDK de cliente para JavaScript/TypeScript y Python. Agent SDK permite crear flujos con llamadas a herramientas, ciclos de conversación y gestión de estado. Consulta la documentación de cada versión.
• Enrutamiento y alternativas: las opciones de enrutamiento y fallback pueden ayudar ante problemas de disponibilidad. El comportamiento depende de la petición, el endpoint y el plan; no garantiza el menor precio ni continuidad en todos los casos.
• Facturación por modelo: el uso de inferencia se cobra según la tarifa publicada del modelo seleccionado. Los planes pueden variar en comisiones, acceso a modelos, presupuestos y otras funciones. Consulta los detalles actuales antes de enviar peticiones.
• Controles de datos: OpenRouter documenta políticas de tratamiento diferentes para cada proveedor y permite filtrar proveedores por cuenta o petición. Antes de enviar datos sensibles, revisa la política del proveedor y los ajustes de privacidad.

Cómo empezar

1. Crea una cuenta y revisa los planes, el catálogo, la facturación y las políticas de datos vigentes.
2. Genera una clave API en el panel y guárdala en una variable de entorno o gestor de secretos. No la publiques en el repositorio, la aplicación cliente ni los registros.
3. Selecciona un modelo y consulta sus requisitos de entrada, salida, herramientas y modalidades. Para OpenAI SDK, sigue las instrucciones oficiales para configurar baseURL, la clave y el nombre del modelo.
4. Prueba formato, facturación, gestión de errores y fallbacks opcionales con datos no sensibles antes de conectar contenido real.
5. Define presupuestos o límites para las claves y revisa periódicamente el uso, los cargos y las políticas de proveedores.

Usos y límites

OpenRouter puede servir a desarrolladores que quieren administrar varias opciones de modelos mediante una sola API. También permite comparar modelos, crear flujos de chat o agentes y usar modelos compatibles de imagen o audio. Las herramientas, salidas estructuradas y funciones multimodales dependen del modelo y del endpoint. Una interfaz común reduce algunas diferencias de integración, pero no elimina las variaciones en parámetros, precios, límites o comportamiento. Tampoco garantiza latencia, precisión o disponibilidad constantes.

Las solicitudes se enrutan al modelo y proveedor seleccionados. Los ajustes de datos de OpenRouter y las políticas de cada proveedor son etapas distintas. Antes de enviar código, datos de clientes o información personal, revisa retención, entrenamiento, región y registros. Valida las salidas de IA en tu aplicación. Los costes varían según el modelo y las condiciones del servicio; contempla errores y fallbacks en tus estimaciones y pruebas.

Preguntas frecuentes

¿Qué es OpenRouter?

Es una plataforma de API multimodelo con catálogo, API unificada y herramientas para desarrolladores como SDK. El catálogo actual indica los modelos y endpoints disponibles.

¿Puedo usar OpenAI SDK?

La documentación oficial describe una integración compatible. Normalmente debes configurar baseURL, clave API y modelo, y confirmar que el modelo admite los parámetros que necesitas.

¿Cómo se cobra el uso?

La inferencia se cobra según la tarifa publicada de cada modelo; los planes pueden añadir comisiones o funciones distintas. Consulta precios y facturación actuales.

¿Cómo se tratan los datos de las solicitudes?

OpenRouter y cada proveedor tienen políticas separadas. Revisa los ajustes de registros, uso de datos y filtrado de proveedores, además de la retención del proveedor seleccionado.