Cómo usar los modelos gratuitos de AIHubMix en JanitorAI: Configuración del proxy y errores comunes

JanitorAI puede comunicarse con cualquier API compatible con OpenAI a través de su opción de Proxy, y AIHubMix es una de ellas. La configuración completa consiste en cuatro valores que se escriben en un formulario:

Nombre:       cualquier cosa que te guste, por ejemplo, AIHubMix MiMo
URL del Proxy:  https://aihubmix.com/v1/chat/completions
Clave API:    tu clave de AIHubMix
Modelo:      xiaomi-mimo-v2.6-pro-free

Deja Custom prompt vacío, presiona Test, luego Add y actualiza la página. Eso es todo.

La mayoría de los fallos reportados en la comunidad de JanitorAI provienen de que uno de esos cuatro campos está ligeramente incorrecto, o de que el nivel gratuito se agota antes de lo esperado. Esta guía explica la configuración una vez, y luego cubre cada error que es probable que veas y qué hacer al respecto.

Antes de comenzar

Necesitas tres cosas:

1. Una cuenta de AIHubMix y una clave API. Regístrate, luego crea una clave en la página de claves API de AIHubMix. Cópiala en un lugar seguro de inmediato.
2. Un bot que permita proxies. Un proxy solo funciona con bots que muestran "proxy permitido" encima del selector de persona o del botón de iniciar chat, como explica esta guía comunitaria de proxies. Los bots con definiciones de personajes visibles generalmente lo permiten.
3. Un ID de modelo. Elige uno de la lista de modelos gratuitos de AIHubMix y copia su ID exactamente. El favorito actual de la comunidad para juegos de rol es xiaomi-mimo-v2.6-pro-free; la guía de modelos en esta serie compara las opciones.

Una cosa que debes saber antes de tu primer mensaje: una nueva cuenta obtiene 10 llamadas de prueba en total, compartidas entre todos los modelos gratuitos. Después de una recarga única de $1 o más, la cuenta cambia a cuotas diarias (100 solicitudes al día, 10 por minuto, 1M de tokens al día). La guía de límites en esta serie explica hasta dónde llega eso en un chat largo.

Los cuatro valores y dónde la gente se equivoca

El ID del modelo va en el campo Modelo. Está en minúsculas y mantiene su sufijo -free. "Xiaomi Mimo V2.6 Pro (gratis)" es el nombre de visualización y no funcionará; xiaomi-mimo-v2.6-pro-free sí lo hará.

\1

Junto a la etiqueta de URL del Proxy hay un botón Add /chat/completions. Solo agrega /chat/completions a lo que ya está en el campo. Si pegaste la URL completa arriba, no lo hagas, o la ruta terminará dos veces. Si pegaste https://aihubmix.com/v1, un clic la completa.

El campo de clave API dice "(opcional)". Rellénalo de todos modos: sin una clave, cada solicitud es rechazada.

Custom prompt anula el aviso del sistema para este proxy y se envía al principio de cada solicitud mientras el proxy esté activo. AIHubMix no necesita uno, así que déjalo vacío.

Configúralo en JanitorAI

JanitorAI rediseñó su configuración de chat el 19 de julio de 2026, por lo que los videos más antiguos muestran pantallas diferentes. Los pasos a continuación se verificaron con la versión web actual en octubre de 2026:

1. Abre un chat con un bot que permita proxies.
2. Abre el menú en la parte superior derecha y elige Settings.
3. Bajo Provider, elige Proxy.
4. Bajo Proxy Configurations, haz clic en + New.
5. En el formulario de New Configuration, completa Name, Proxy URL, API key y Model con los valores anteriores. Deja Custom prompt vacío.
6. Haz clic en Test. Si la configuración funciona, no aparece nada; un mensaje aparece solo cuando algo está mal.
7. Haz clic en Add, luego actualiza la página o reinicia el chat.

La actualización en el paso 7 es el paso que más gente omite. Hasta que la página se recargue, JanitorAI puede seguir enviando mensajes a través de la configuración anterior.

Puedes guardar varias configuraciones, por ejemplo, una por modelo, lo que hace que cambiar sea rápido cuando un modelo está ocupado. Para agregar una copia de seguridad, abre una configuración guardada, haz clic en Duplicate y cambia solo el campo Modelo.

Configuraciones para tu primer chat

Abre el menú → Settings nuevamente y observa los controles de generación. Dos de ellos son importantes para una primera ejecución, según el tutorial de Arcanum RPGs sobre el panel actual:

• Tamaño del contexto. Con un modelo externo, el control deslizante llega hasta 128,000 tokens. Comienza entre 16,000 y 32,000. La propia herramienta de JanitorAI dice que lo bajes si las respuestas no se generan.
• Max tokens. 0 permite que el modelo elija la longitud de la respuesta. Cualquier otro número es un límite estricto, por lo que un valor bajo puede cortar respuestas a mitad de oración.

Presiona Save; nada se aplica hasta que lo hagas.

El tamaño del contexto importa más que la calidad. Cada turno envía todo el contexto nuevamente, y todos los modelos gratuitos comparten un único grupo de 1M de tokens por día. Una vez que un chat llena un contexto de 32,000 tokens, ese grupo cubre aproximadamente 30 respuestas, muy por debajo del límite de 100 solicitudes. La guía de límites en esta serie trabaja con los números.

Opcional: prueba tu clave fuera de JanitorAI

Si te sientes cómodo con una terminal, esta solicitud separa "mi clave es incorrecta" de "mi configuración de JanitorAI es incorrecta". Utiliza el mismo endpoint que documenta el inicio rápido de AIHubMix, y utiliza una solicitud (una de tus 10 llamadas de prueba si no has recargado).

export AIHUBMIX_API_KEY="pega-tu-clave-aquí"

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "xiaomi-mimo-v2.6-pro-free", "messages": [{"role": "user", "content": "Di hola en cinco palabras."}]}'

Una respuesta con texto significa que la clave y el ID del modelo están bien, y el problema está en los campos de JanitorAI o en la falta de actualización.

Errores comunes y cómo solucionarlos

"Error de red" o "Error al obtener"

La prueba muestra "Error de red. ¡Inténtalo de nuevo más tarde!", o el chat muestra "Ocurrió un error de red, es posible que estés limitado por la tasa o tengas problemas de conexión: Error al obtener".

• Por qué: La solicitud nunca llegó a AIHubMix, o la respuesta nunca volvió a tu navegador. A pesar de la redacción, "Error al obtener" apunta a un problema de conexión, no a una cuota. La causa habitual es un VPN o proxy que bloquea o redirige incorrectamente a aihubmix.com; una extensión del navegador que filtra solicitudes puede hacer lo mismo. En la propia prueba de AIHubMix de esta guía, un VPN fue la causa.
• Solución: Apaga el VPN, cambia a otro servidor, o asegúrate de que permita aihubmix.com. Pausa las extensiones de bloqueo de anuncios o de privacidad en janitorai.com. Luego presiona Probar nuevamente.

La prueba muestra un error, o el bot nunca responde

• Por qué: La URL del Proxy está incompleta (solo la URL base o la página de inicio), tiene un error tipográfico, o termina en /chat/completions dos veces porque se hizo clic en el botón Agregar /chat/completions después de pegar la URL completa. AIHubMix responde a una ruta incorrecta con "El endpoint de API solicitado no existe."
• Solución: Pega https://aihubmix.com/v1/chat/completions exactamente, sin espacio al final.

"Modelo no encontrado" o un error de modelo

• Por qué: El campo Modelo contiene un nombre de visualización, tiene una letra mayúscula, o perdió su sufijo -free.
• Solución: Copia el ID de la lista de modelos gratuitos nuevamente y pégalo tal como está.

"Clave inválida" o un error de autenticación

• Por qué: La clave pertenece a otro servicio, fue eliminada, tiene un espacio adicional, o el campo está vacío. AIHubMix devuelve "no se proporcionó clave" para una clave vacía y "clave inválida" para una incorrecta.
• Solución: Crea una nueva clave en la página de claves de AIHubMix y pégala nuevamente.

Cambiaron las configuraciones pero nada cambió

• Por qué: JanitorAI sigue usando la configuración que cargó antes.
• Solución: Actualiza la página o reinicia el chat, y verifica que la configuración correcta esté seleccionada.

La "respuesta" del bot es un aviso de que tu prueba se ha agotado

• Por qué: Las 10 llamadas de prueba se han agotado. AIHubMix sigue respondiendo con una nota en lugar de un error, por lo que en JanitorAI probablemente aparece como un mensaje en el chat.
• Solución: Recarga $1 o más una vez; la cuenta cambia a cuotas diarias para modelos gratuitos. La guía de recarga en esta serie cubre los pasos.

Error 429

Un 429 tiene dos causas comunes:

• Has alcanzado un límite. Pasado tu límite por minuto o por día, la API devuelve 429 hasta que comience el siguiente minuto o día. Algunos modelos tienen límites más bajos que los 100 al día y 10 por minuto estándar (por ejemplo, qwen3.6-plus-preview-free permite 50 al día y 5 por minuto), y el grupo compartido de 1M de tokens puede agotarse primero en chats largos.
• El modelo está ocupado. La capacidad gratuita en algunos modelos es limitada, y el registro de cambios de AIHubMix ha advertido que los errores 429 "pueden ocurrir" en un modelo gratuito por esa razón. Cuando muchas personas se acumulan en un modelo popular a la vez, esta es la causa habitual.

Solución: Espera un minuto y vuelve a intentarlo, envía mensajes con menos frecuencia, o cambia a una segunda configuración guardada con un modelo diferente. Si el límite diario es el problema, la cuota se restablece una vez al día.

Un 404 que menciona model_retired

• Por qué: El modelo ha sido eliminado. Desde el 1 de septiembre de 2026, los modelos retirados devuelven un explícito model_retired 404.
• Solución: Elige otro modelo de la lista gratuita y actualiza el campo Modelo.

Los modelos gratuitos dejaron de funcionar después de usar modelos de pago

• Por qué: Cuando el saldo de una cuenta cae por debajo de -$1, no se pueden llamar modelos gratuitos hasta que la cuenta se recargue nuevamente.
• Solución: Recarga para llevar el saldo de vuelta por encima de esa línea.

¿Aún atascado?

La página de contacto de AIHubMix enumera el servidor oficial de Discord, el correo electrónico de soporte (feedback@aihubmix.com) y la página de estado. La página de estado rastrea servicios como Chat Completions, no modelos individuales, por lo que un modelo ocupado no aparecerá allí.

Para obtener una respuesta rápida, incluye:

• la hora de la solicitud y tu zona horaria
• el ID del modelo y el endpoint (la URL del Proxy)
• el estado HTTP o el texto de error, y un ID de seguimiento si se mostró uno
• lo que esperabas y lo que sucedió en su lugar

Deja fuera tu clave API. El soporte no la necesita, y cualquiera que la tenga puede gastar tu cuota.

FAQ

¿Es AIHubMix gratuito para usar en JanitorAI?
Cada nueva cuenta obtiene 10 llamadas de prueba en todos los modelos gratuitos. Después de una recarga única de $1 o más, los modelos gratuitos cambian a cuotas diarias: 100 solicitudes al día, 10 por minuto y 1M de tokens al día compartidos entre ellos.

¿Qué va exactamente en el campo URL del Proxy?
https://aihubmix.com/v1/chat/completions, la dirección completa. Si pegas solo https://aihubmix.com/v1, haz clic en el botón Agregar /chat/completions una vez para completarlo.

¿Por qué no veo la opción de proxy para algunos bots?
Solo los bots marcados como "proxy permitido" funcionan con un proxy. Otros bots permanecen en el modelo propio de JanitorAI.

¿Con qué ID de modelo debería comenzar?
Cualquier ID de la lista de modelos gratuitos funciona si se copia exactamente. Muchos usuarios de JanitorAI comienzan con xiaomi-mimo-v2.6-pro-free; la guía de modelos en esta serie compara las alternativas.

¿Necesito actualizar después de cambiar el modelo?
Sí. Guarda la configuración, luego actualiza la página o reinicia el chat para que JanitorAI reconozca el cambio.

¿Por qué sigo recibiendo errores 429?
O bien has superado un límite por minuto o por día, o el modelo está ocupado. Espera un minuto, desacelera, o cambia a otra configuración guardada con un modelo diferente.

¿Puedo compartir mi clave API con amigos?
No. Los Términos de Servicio prohíben compartir una cuenta de AIHubMix, y cualquiera que use tu clave gasta tu cuota diaria.

Sigue leyendo: la serie AIHubMix para JanitorAI

• Tu configuración funciona, pero ¿cuántos mensajes te dará realmente por día? Las matemáticas de tokens están aquí: Límites de Modelos Gratuitos de AIHubMix para JanitorAI: 10 Llamadas de Prueba, el Desbloqueo de $1 y el Límite de Tokens
• Si el aviso de prueba ya apareció en tu chat, esto explica cómo desbloquear las cuotas diarias: Cómo Pagar en AIHubMix con Alipay
• ¿No estás seguro de que el ID de modelo que pegaste sea el correcto para juegos de rol? Compara las opciones gratuitas: Qué Modelo Gratuito de AIHubMix Usar para Juegos de Rol en JanitorAI
• Antes de tu primer chat largo, ve cómo la retención de datos cero evita que tus mensajes se almacenen en AIHubMix: AIHubMix Soporta Chat de Juegos de Rol en JanitorAI, con Retención de Datos Cero Activada por Defecto

Fuentes

• Modelos AI Gratuitos (AIHubMix)
• Inicio Rápido (Documentos de AIHubMix)
• Registro de Cambios (Documentos de AIHubMix)
• custom-proxy-for-janitorai (GitHub)
• Configuraciones de Generación de Janitor AI (2026) (Arcanum RPGs)