OpenRouter Beta
4 min de lectura
OpenRouter es una pasarela: con una sola clave y un solo saldo, tus agentes pueden usar modelos de muchos proveedores. Cada conexión lleva dentro el modelo que utiliza, así que para usar dos modelos distintos creas dos conexiones.
Funciona mejor con Claude
OpenRouter solo garantiza el funcionamiento de los agentes con los modelos de Claude. Otros modelos pueden responder bien a una conversación y fallar al usar herramientas o al lanzar subagentes. Empieza con un modelo de Claude y prueba los demás en un agente que no esté en producción.
Antes de conectarlo
Añade saldo
OpenRouter cobra por uso con saldo prepago. Recárgalo en Settings > Credits.
Crea una clave
En Settings > Keys, crea una clave para Kujira. Solo se muestra una vez.
Limita lo que puede hacer esa clave
En Settings > Privacy > Guardrails puedes asignar a la clave un límite de gasto y una lista de modelos o proveedores permitidos. Es la forma de acotar el gasto de tus agentes y, si usas el enrutador automático, de decidir entre qué modelos elige.
Qué modelo lleva la conexión
| Opción | Qué escribir | Cuándo elegirla |
|---|---|---|
| Un modelo concreto | El identificador de OpenRouter, por ejemplo anthropic/claude-sonnet-5. | Es la opción recomendada: sabes qué modelo responde y cuánto cuesta. |
| El enrutador automático | openrouter/auto, o cualquier otro enrutador de OpenRouter (openrouter/auto-beta, openrouter/free…) | OpenRouter elige el modelo en cada petición según la tarea. Por defecto prioriza modelos económicos. |
| Un preset | @preset/ seguido de su nombre | Reutilizas una configuración guardada en OpenRouter: modelos de respaldo, proveedores o parámetros. |
Si usas el enrutador automático
Limita en los guardarraíles de la clave los modelos permitidos a los de Anthropic. Así el enrutador solo elige entre modelos de Claude, que son los que funcionan de forma fiable con los agentes.
Crear la conexión
En Ajustes > Modelos > OpenRouter, pulsa Añadir conexión.
Nombra la conexión
El nombre es obligatorio y es lo que verás al elegirla en un agente. Si vas a tener varias, di qué modelo lleva: «OpenRouter · Sonnet», «OpenRouter automático».
Pega la clave
La dirección del servicio ya viene rellena. Cámbiala solo si pasas por un proxy propio.
Elige el modelo
Escribe para buscar entre los que sirve OpenRouter y elígelo de la lista. Debajo verás cuánto contexto tiene: esa cifra la leemos del catálogo de OpenRouter, no hace falta que la sepas.
También puedes escribir openrouter/auto o un preset, como en la tabla de arriba. Entonces Kujira te pedirá la ventana de contexto —opcional— porque no puede saberla: cada respuesta puede venir de un modelo distinto, y el límite se fija al arrancar el agente. Sin ella, el agente resume la conversación al llegar a 200.000 tokens. Si has acotado tu clave a modelos más grandes, escribe la ventana del más pequeño que permitas.
Asigna la conexión al agente
En Configuración > Modelo del agente, elige esa conexión en el desplegable Conexión. Como la conexión trae su propio modelo, es el que correrá. Si el agente está en marcha, se reinicia solo al guardar.
Qué sabe el agente de su modelo
El agente sabe que corre por OpenRouter y con qué modelo. Si le preguntas cuál es, te dice la conexión y, con el enrutador, qué modelo ha contestado su último mensaje: no se presenta como Claude si no lo es.
El modelo lo fija la conexión, así que el agente no puede cambiarlo desde la conversación. Si quieres otro, cambia el modelo de la conexión o asígnale otra conexión al agente.
Coste
OpenRouter cobra de tu saldo la tarifa del modelo que responde, y Kujira calcula el gasto de cada agente con esa misma tarifa, la que OpenRouter publica de cada uno de sus modelos. Vale para cualquiera: Claude, DeepSeek, Llama o el que elijas. La cifra que ves en el panel es la que te van a cobrar, salvo diferencias de redondeo.
Con el enrutador automático funciona igual: cada respuesta puede venir de un modelo distinto y cada una se cuenta a la tarifa del que haya contestado.
Kujira relee las tarifas de OpenRouter varias veces al día, así que un cambio de precio se recoge solo. La cifra oficial está siempre en tu panel de OpenRouter.
Errores frecuentes
Falla el primer mensaje
Comprueba el identificador del modelo: debe coincidir exactamente con el de OpenRouter, incluido el prefijo del proveedor (anthropic/).
OpenRouter no tiene cómo servir ese modelo
El modelo no existe o los guardarraíles de la clave no permiten ningún proveedor que lo sirva. Revisa el identificador y la lista de modelos y proveedores permitidos.
El agente deja de contestar
Revisa el saldo y el límite de gasto de la clave. Cuando se agotan, OpenRouter rechaza las peticiones hasta que recargues o subas el límite.
Falla al usar herramientas
Con un modelo que no es de Claude, prueba con uno de Claude antes de revisar nada más. Si usas el enrutador, limita los modelos permitidos a los de Anthropic.
Consulta Modelos para ver cómo se eligen las conexiones y los modelos de cada agente.