Conecta un modelo de IA propio: endpoint, claves y respaldo
Configura un modelo compatible con OpenAI en Mono, prueba la conexión y distingue las respuestas de texto de la ejecución de herramientas.
Un endpoint propio permite enviar las solicitudes al servidor que elijas. El modelo puede ejecutarse en tu ordenador o en un proveedor externo; introducir su dirección no hace que se ejecute en el teléfono. Empieza con una petición breve y sin datos sensibles.
Mono by Reunified te permite usar tu propio modelo, y las respuestas de un modelo que ejecutas tú no cuestan nada en Mono. Mono está ahora en lista de espera. Esta guía muestra los ajustes y te da una lista de comprobación para cuando tengas acceso. Aunque un servidor diga que es compatible, pruébalo con tu app y tu modelo exactos.
1. Reúne los datos de conexión
Necesitas la URL base de la API, el identificador exacto del modelo y, si hace falta, una clave de API. Sigue las instrucciones de quien gestiona el servidor. La dirección de un sitio web, una página de descarga de modelos o la URL de un servidor MCP no son un endpoint de API de modelos.
Mono envía las solicitudes de texto a la ruta Chat Completions bajo la dirección que introduces, así que escribe la base de la API, no la ruta completa. Por ejemplo, si tu proveedor documenta https://models.example.com/v1/chat/completions, introduce https://models.example.com/v1. Es una dirección inventada, no un servicio real.
Comprueba qué más admite el modelo. Que responda texto no significa que admita imágenes, herramientas, streaming o todas las opciones de una solicitud.
2. Configura una función del modelo
Abre Ajustes, luego Integraciones, y activa Modelo de texto en Endpoints personalizados. Escribe la URL del endpoint, la clave de API y el ID del modelo en sus campos. No pongas claves en mensajes de chat ni en capturas de pantalla. Un servidor local sin inicio de sesión puede no necesitar clave, pero eso no lo hace seguro para abrirlo a internet.
Empieza por el modelo de texto. Mono tiene ajustes separados para los modelos de texto, de código y de soporte, así que cambiar uno no cambia los demás. Anota cuál cambiaste, para saber por dónde empezar si algo falla después.
Con un modelo de texto personalizado, algunas funciones, como las herramientas y las skills, pueden no funcionar igual que con los modelos integrados de Mono. Prueba primero una conversación normal. Si un flujo necesita skills, una buena respuesta de texto no demuestra que el flujo vaya a funcionar.
3. Decide qué hacer si falla la conexión
Cada modelo personalizado tiene un interruptor «Usar el modelo por defecto si no está disponible», y viene activado. No des por hecho que todas las funciones reaccionan igual ante un servidor caído. Pruébalo: detén tu servidor y mira qué pasa en la función que usas.
Si tus solicitudes solo deben ir a tu propio servidor, por privacidad o por costes, desactiva este interruptor y prueba qué pasa cuando tu servidor falla. Comprueba adónde van de verdad las solicitudes; un ajuste en pantalla no basta. Cambiar el modelo de texto deja además por revisar los otros modelos y las herramientas conectadas.
Consulta la guía de privacidad y la comparación de costes antes de enviar información sensible.
4. Haz una prueba pequeña
Pide: «Devuelve las tres palabras rojo, verde, azul en líneas separadas». Comprueba que llega la respuesta, que los registros de tu servidor (si los tiene) muestran el modelo que elegiste y que la página de uso del proveedor coincide con tu prueba.
Después prueba una función que de verdad necesites, como una conversación más larga. Cambia una sola cosa cada vez. Anota la versión de la app, la del servidor, el ID del modelo y la fecha; que funcione una combinación no significa que funcionen todos los modelos.
Si el servidor está en tu ordenador, prueba también desde la red real del móvil. localhost en el móvil es el propio móvil. Usa un método de conexión con inicio de sesión que admita tu servidor, en vez de abrir a internet un servicio sin protección.
5. Localiza la primera capa que falla
| Síntoma | Primera comprobación |
|---|---|
| Tiempo de espera agotado | Servidor en marcha, el dispositivo llega a él, reglas de red |
| Acceso no autorizado | Clave correcta, cuenta y requisitos de inicio de sesión |
| Error de no encontrado | URL base, y si se añadió dos veces la ruta /chat/completions |
| Modelo desconocido | ID exacto del modelo disponible en ese servidor |
| El texto funciona, el flujo no | Herramientas u otras funciones que necesita el flujo |
Quita los secretos de cualquier registro que compartas. Iniciar sesión en la web del proveedor no demuestra que tu clave de API funcione, y que la prueba de texto funcione no significa que el modelo de código esté configurado.
6. Conserva una configuración reversible
Anota tus ajustes anteriores, sin los secretos. Después de cambiar de servidor, repite la prueba pequeña y revisa los costes tanto en la app como en el proveedor. Revisa los demás ajustes de modelo antes de llamar «local» o «privada» a una configuración.
Apúntate a la lista de Mono. Si necesitas conectar un servicio externo en vez de cambiar de modelo, sigue la guía de MCP.
