Guía de la API key de OpenRouter

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.

Actualizado
  • 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.
Oriveo en iPhone: la pantalla de proveedores, con los proveedores que has conectado y el gasto de este mes.

¿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.
¿La API de OpenRouter es gratis?
Tu cuentaSolicitudes por minuto a modelos gratisSolicitudes por día a modelos gratis
Compraste menos de 10 créditos en total2050
Compraste al menos 10 créditos en total201000

¿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».
Pantalla de inicio de Oriveo con el cuadro de mensaje, el modelo elegido debajo y los chats de hoy, cada uno con su costo
Después de conectar la clave, elige un modelo debajo del cuadro de mensaje. Cada chat de la lista muestra su costo estimado.

¿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.
¿Por qué no funciona mi API key de OpenRouter?
ErrorQué significaQué hacer
401 Invalid credentialsLa clave es incorrecta, está desactivada o fue borradaVuelve a copiar la clave completa, o crea una nueva
401 «this is not an OpenRouter API key»Pegaste la clave de otro proveedorUsa una clave de openrouter.ai/keys; empieza por sk-or-v1-
402 insufficient creditsTu cuenta o esta clave se quedó sin créditosAgrega créditos o sube el límite de la clave; esperar no sirve
403 ForbiddenLa solicitud queda bloqueada por permisos, moderación, una regla de protección (guardrail) o un límite de presupuestoRevisa la configuración y los límites de la clave, o cambia tu mensaje
429 rate limitedDemasiadas solicitudes, para OpenRouter o para el proveedor del modeloEspera y reintenta; con modelos gratis, revisa los límites de arriba
502 o 503El modelo o sus proveedores no están disponibles en este momentoInté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?
En parte. La clave es gratis, y los modelos cuyo ID termina en «:free» no cuestan nada dentro de límites diarios: a 18 de noviembre de 2026, 50 solicitudes al día, o 1000 si compraste al menos 10 créditos. Los demás modelos necesitan créditos prepagados.
¿Dónde obtengo mi API key de OpenRouter?
En openrouter.ai/keys, después de iniciar sesión. Crea una clave, ponle un nombre y cópiala completa; empieza por «sk-or-v1-».
¿OpenRouter tiene app para iPhone o Android?
OpenRouter no publica una app de chat propia para celular. Usa una app de chat que acepte una clave de OpenRouter: en Oriveo, abre «Proveedores», toca +, elige OpenRouter, pega la clave y toca «Continuar».
¿Qué significa el error 402 de OpenRouter?
Que tu cuenta o la clave que usas no tiene créditos suficientes. Agrega créditos en OpenRouter, o sube el límite de la clave si le pusiste uno, y vuelve a intentarlo. No se arregla solo.
¿Por qué no funciona mi API key de OpenRouter?
Mira el número del error. 401 significa que la clave es incorrecta o no es de OpenRouter; 402, que no tienes créditos; 429, demasiadas solicitudes o el límite de los modelos gratis. Nuestra guía de errores de API key explica cada código.
¿Cómo es una API key de OpenRouter?
Empieza por «sk-or-v1-» seguido de 64 letras y números: 73 caracteres en total. Si la tuya es más corta, una parte no se copió.

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.