API key de OpenRouter: cómo obtenerla y usar modelos gratis
Crea tu API key de OpenRouter, conoce los límites de los modelos gratis, resuelve los errores 401, 402 y 429, y usa OpenRouter en iPhone, Android o la web.
- Para obtener una clave de API (API key) de OpenRouter, inicia sesión en openrouter.ai, abre openrouter.ai/keys y crea una clave; empieza por «sk-or-v1-». Crear la clave es gratis, los modelos cuyo ID termina en «:free» se pueden usar dentro de límites diarios y todos los demás se pagan con créditos prepagados.
- OpenRouter es una sola cuenta y una sola clave para modelos de muchas empresas de IA. No publica una app de chat propia para iPhone ni Android, así que en el celular se usa con una app de chat que acepte una clave de OpenRouter, como Oriveo.
- A 18 de noviembre de 2026, los modelos gratis permiten 20 solicitudes por minuto y 50 al día, o 1000 al día si compraste al menos 10 créditos. El error 402 significa que te quedaste sin créditos.

¿Qué es OpenRouter y qué es una API key?
OpenRouter es un servicio que te da acceso a modelos de muchas empresas de IA con una sola cuenta. En lugar de registrarte en cada empresa, cargas créditos en OpenRouter una vez y eliges modelos de su lista.
Una clave de API es el código secreto que usa una app para hacer solicitudes con tu cuenta. OpenRouter comprueba la clave, envía tu mensaje al modelo que elegiste y descuenta el costo de tus créditos de OpenRouter.
OpenRouter está pensado para apps y desarrolladores. No publica una app de chat propia para iPhone ni Android, y por eso tanta gente busca una «app de OpenRouter». Lo que en realidad necesitan es una app de chat que acepte una clave de OpenRouter.
¿Cómo obtener una API key de OpenRouter?
Te toma un par de minutos en el sitio web de OpenRouter.
- Entra a openrouter.ai y crea una cuenta, o inicia sesión.
- Abre la página de claves en openrouter.ai/keys y crea una clave nueva. Ponle el nombre de la app o el dispositivo donde la vas a usar.
- Copia la clave. Las claves de OpenRouter empiezan por «sk-or-v1-» y tienen 73 caracteres, así que comprueba que la copiaste completa.
- Si quieres usar modelos que no son gratis, agrega créditos en la página Credits.
- Guarda la clave en un lugar seguro, como un administrador de contraseñas. Si se filtra, bórrala en la página de claves y crea otra.
¿La API de OpenRouter es gratis?
En parte. Crear una cuenta y una clave no cuesta nada, y OpenRouter ofrece modelos gratis cuyo ID termina en «:free». Todo lo demás se paga con créditos prepagados. OpenRouter también dice que los usuarios nuevos reciben una pequeña cantidad de crédito gratis, pero no dice cuánto.
Los modelos gratis tienen límites. Estos son los que publica OpenRouter, a 18 de noviembre de 2026:
- Si tu saldo baja de cero, OpenRouter advierte que incluso los modelos gratis pueden devolver errores.
- El sitio de OpenRouter muestra qué modelos tienen ahora una versión «:free»; revísalo antes de depender de uno.
| Tu cuenta | Solicitudes por minuto a modelos gratis | Solicitudes por día a modelos gratis |
|---|---|---|
| Compraste menos de 10 créditos en total | 20 | 50 |
| Compraste al menos 10 créditos en total | 20 | 1000 |
¿Cómo funcionan los créditos de OpenRouter?
OpenRouter es prepago. Compras créditos en la página Credits con tarjeta o con alguno de los otros métodos de pago que aparecen ahí, y cada solicitud se descuenta de ellos. A 18 de noviembre de 2026, los términos de OpenRouter fijan un mínimo de $5 USD por compra, suman una comisión de pago y dicen que los créditos sin usar pueden vencer 365 días después de la compra. Consulta openrouter.ai/terms para ver las condiciones vigentes.
Cada modelo tiene su propio precio por token, que aparece en su página de OpenRouter. No copiamos los precios aquí porque cambian. Oriveo muestra un costo estimado en cada respuesta; las páginas de actividad y facturación de OpenRouter son el registro definitivo.
¿Cómo usar OpenRouter en iPhone, Android o la web?
Como OpenRouter no tiene una app oficial para celular, eliges una app cliente. En Oriveo, OpenRouter es uno de los 15 proveedores integrados y aparece en «Agregadores», así que no tienes que escribir ninguna dirección.
- Abre «Proveedores»: es una pestaña en iPhone y Android, y está en la barra lateral en la web.
- Toca el botón + («Agregar proveedor») y elige OpenRouter. El filtro «Agregadores» acota la lista.
- Pega tu clave en «Conectar OpenRouter» y toca «Continuar».
- Espera a que termine «Validando conexión y sincronizando modelos...». Oriveo carga la lista de modelos de OpenRouter.
- Elige un modelo y empieza a chatear. Si no tienes créditos, elige uno cuyo ID termine en «:free».

¿A dónde va mi API key de OpenRouter?
En iPhone y Android, las solicitudes van directamente de tu dispositivo al proveedor, y la clave se guarda en el almacenamiento seguro del teléfono (el Llavero, o Keychain, en iPhone; el Keystore en Android). En la app web, las solicitudes pasan por un reenvío en tiempo real en el servidor de Oriveo: tu clave solo se usa para esa solicitud y no se guarda como dato de tu cuenta, y los chats BYOK no se almacenan como registros de chat. La sincronización en la nube no sube las claves. Para usar OpenRouter en un segundo dispositivo, pega ahí también la clave o crea una clave aparte para él.
Le pagas a OpenRouter directamente, a sus precios. Oriveo no agrega ningún recargo.
¿Por qué no funciona mi API key de OpenRouter?
La página de errores de OpenRouter (openrouter.ai/docs/api-reference/errors) explica qué significa cada código. Los más comunes, a 18 de noviembre de 2026:
- En Oriveo, un 402 aparece como «Cuota del proveedor agotada», y un 429 como «Límite de velocidad» en la web o «Límite de tasa del proveedor» en iPhone y Android.
- Falta un modelo en tu lista: vuelve a sincronizar la lista de modelos y comprueba que OpenRouter lo siga ofreciendo.
| Error | Qué significa | Qué hacer |
|---|---|---|
| 401 Invalid credentials | La clave es incorrecta, está desactivada o fue borrada | Vuelve a copiar la clave completa, o crea una nueva |
| 401 «this is not an OpenRouter API key» | Pegaste la clave de otro proveedor | Usa una clave de openrouter.ai/keys; empieza por sk-or-v1- |
| 402 insufficient credits | Tu cuenta o esta clave se quedó sin créditos | Agrega créditos o sube el límite de la clave; esperar no sirve |
| 403 Forbidden | La solicitud queda bloqueada por permisos, moderación, una regla de protección (guardrail) o un límite de presupuesto | Revisa la configuración y los límites de la clave, o cambia tu mensaje |
| 429 rate limited | Demasiadas solicitudes, para OpenRouter o para el proveedor del modelo | Espera y reintenta; con modelos gratis, revisa los límites de arriba |
| 502 o 503 | El modelo o sus proveedores no están disponibles en este momento | Inténtalo más tarde o elige otro modelo |
¿OpenRouter o una clave de cada proveedor?
OpenRouter es práctico cuando quieres muchos modelos con una sola clave y un solo saldo. Una clave directa de un proveedor como OpenAI o Anthropic te conviene cuando quieres la cuenta y la facturación propias de ese proveedor. Oriveo acepta las dos, así que puedes tener OpenRouter junto a tus claves directas e ir cambiando de modelo, uno tras otro, en la misma conversación.
Preguntas frecuentes sobre la app
¿OpenRouter es gratis?
¿Dónde obtengo mi API key de OpenRouter?
¿OpenRouter tiene app para iPhone o Android?
¿Qué significa el error 402 de OpenRouter?
¿Por qué no funciona mi API key de OpenRouter?
¿Cómo es una API key de OpenRouter?
Lecturas relacionadas
Del blog
Usa tu clave de OpenRouter en el celular
Abre la app web o descarga Oriveo para iPhone o Android, pega tu clave de OpenRouter y cambia de modelo con un costo estimado en cada respuesta.
¿Todavía no tienes una clave de API? Con Oriveo Free puedes empezar sin ella.