¿Cómo compruebo mis créditos y mi gasto en OpenRouter?

Última actualización: 26 de septiembre de 2026

Tu saldo está en la página Credits, en openrouter.ai/settings/credits. La página Activity, en openrouter.ai/activity, muestra lo que gastaste, por modelo, proveedor y clave de API. Desde código, GET /api/v1/key muestra lo que ha gastado una clave y cuánto de su tope le queda.

A continuación: las dos llamadas a la API y qué clave necesita cada una, los topes por clave, qué pasa en cero y qué comisiones se aplican. Sigue la documentación de OpenRouter en la fecha indicada arriba.

En el sitio web

Página Credits (openrouter.ai/settings/credits). Tu saldo y dónde recargas. OpenRouter cuenta los créditos en dólares estadounidenses. Puedes recargar a mano o activar la recarga automática, que rellena el saldo cuando baja de un umbral que fijas.
Página Activity (openrouter.ai/activity). Tu gasto, solicitudes y tokens en cualquier intervalo de fechas. Puedes filtrar por modelo, proveedor y clave de API, y exportar los resultados a CSV o PDF.

OpenRouter cobra el precio de lista por token y lo descuenta de tus créditos tras cada solicitud.

A través de la API

Aquí importan dos llamadas, y piden claves distintas.

GET https://openrouter.ai/api/v1/key: envíala con la clave de API normal, como token Bearer. Informa de esa clave: usage (histórico), usage_daily, usage_weekly y usage_monthly, todos en créditos. El día, la semana y el mes siguen UTC; la semana empieza el lunes. Devuelve también el tope de la clave (limit, limit_remaining, limit_reset), el uso BYOK en campos aparte y is_free_tier, que indica si alguna vez has pagado por créditos.
GET https://openrouter.ai/api/v1/credits: devuelve total_credits (comprados) y total_usage (usados) de toda la cuenta. Tu saldo es lo primero menos lo segundo. La referencia de OpenRouter dice que esta llamada necesita una clave de gestión. La creas en la página Management API Keys. Sirve solo para tareas de administración, como gestionar claves, y no puede llamar a modelos.

GET /api/v1/key funciona con la clave de API normal que usas para las solicitudes e informa solo de esa clave. GET /api/v1/credits devuelve los créditos comprados y usados de toda la cuenta, pero OpenRouter dice que necesita una clave de gestión, que no puede llamar a modelos.

Así que /api/v1/key no muestra el saldo de tu cuenta. Si usas varias claves, cada una muestra solo su propio gasto.

Topes por clave

Puedes dar a cada clave de API su propio tope de gasto. Es opcional; sin él, limit y limit_remaining vuelven vacíos, lo que significa «sin tope», no «no queda nada». Un tope puede restablecerse a diario, semanal o mensualmente: limit_reset nombra el ritmo, no una fecha. Un restablecimiento diario ocurre a medianoche UTC.

Un tope no añade dinero. Solo impide que una clave gaste más de lo que permites, aunque la cuenta tenga de sobra. Un ajuste de la clave decide si el uso BYOK cuenta para el tope.

Qué pasa en cero

Las solicitudes fallan con el error 402, Payment Required. Con saldo negativo esto puede afectar también a los modelos gratuitos. Añade créditos para llevar el saldo por encima de cero y vuelven a funcionar.

El cuerpo del error indica qué límite alcanzaste, en metadata.limit_source:

openrouter_credits: el saldo no cubre la solicitud.
openrouter_key_limit: el tope de la clave se ha agotado. Súbelo o espera al restablecimiento.
openrouter_in_flight_budget: hay demasiadas solicitudes de pago en curso a la vez para tu saldo. OpenRouter retiene una estimación del coste de cada solicitud mientras se ejecuta. En cuentas con poco saldo, y en algunas más nuevas, el total retenido puede alcanzar un límite antes que el saldo. Espera el tiempo de la cabecera Retry-After y reintenta.

Los modelos gratuitos (IDs que acaban en :free) tienen sus propios límites de solicitudes: 20 por minuto, y 50 al día si has comprado menos de 10 créditos en total, 1000 al día si has comprado al menos 10. /api/v1/key muestra el recuento diario en free_model_daily_requests.

Comisiones

OpenRouter dice que no añade recargo a los precios de los modelos. Cobra una comisión al comprar créditos: el 5,5 %, con un mínimo de US$ 0,80, con tarjeta, y el 5 % con criptomonedas.

Con BYOK («bring your own key») guardas en OpenRouter una clave de otro proveedor, y ese proveedor te factura los tokens. ¿Cobra OpenRouter por eso?

Sí, por encima de una franquicia gratuita. El pago por uso incluye US$ 25 000 de uso a precio de lista al mes, Enterprise US$ 200 000. Por encima de eso, la comisión es del 5 % de lo que costaría el mismo modelo y proveedor en OpenRouter, descontada de tus créditos.

Dos reglas más de las FAQ de OpenRouter. Puede hacer caducar créditos sin usar un año después de la compra. Y solo puedes pedir el reembolso de créditos sin usar dentro de las 24 horas siguientes a comprarlos, con el botón de reembolso de la página Credits; la comisión no se reembolsa.

Qué lee AI Cockpit de OpenRouter y de las demás cuentas de API está en Los costes de las API de IA de un vistazo.

En AI Cockpit

La tarjeta de OpenRouter está en la barra de menús del Mac, en la app del iPhone y del iPad, y en el área de notificación de Windows. En el Apple Watch (a través de la app del iPhone) aparece como una línea de la lista de fuentes. Basta una clave de API normal; no hace falta clave de gestión.

Lo que la clave gastó hoy, esta semana, este mes y en total, en dólares estadounidenses, leído de /api/v1/key. En el Mac se actualiza cada cinco minutos por defecto.
Si tienes uso BYOK este mes, una línea para él, separada del gasto en créditos.
Si la clave tiene un tope, una barra con la parte usada y el ritmo de restablecimiento, como «mensual». Pasa a color de aviso por defecto al 75 % y al 90 % en el Mac, y al 80 % y al 95 % en iPhone y Apple Watch. Sin tope, la tarjeta lo dice y no muestra ninguna barra.
Una insignia «Free tier» si nunca has comprado créditos.

Lo que no muestra: el saldo de tu cuenta (la app no llama a /api/v1/credits), el gasto por modelo ni el recuento de solicitudes de modelos gratuitos. Tampoco puede recargar.

Respuestas breves a otras preguntas en la página de FAQ.