¿Quieres usar tu propio modelo de IA para programar sin una configuración complicada? Droid lo facilita al admitir APIs externas en su CLI, así puedes conectar un modelo personalizado que se ajuste a tu flujo de trabajo. Esta guía te muestra cómo configurar la API, solucionar problemas comunes y usar Kimi en Droid. Sigue leyendo para comenzar.
¿Qué es Droid?
Droid es una herramienta de programación con IA que ayuda a los desarrolladores a escribir código, resolver errores y realizar tareas de desarrollo de forma más eficiente. Admite modelos de IA integrados y también permite a los usuarios conectar modelos personalizados a través de su CLI para mayor flexibilidad. Esto lo hace útil para distintos flujos de trabajo de programación, ya sea que necesites ayuda rápida o una configuración más personalizada.
¿Cómo usar los modelos de IA integrados en Droid?
Los modelos de IA integrados facilitan comenzar a programar con Droid porque no necesitas conectarte primero a ninguna API externa. Una vez instalada la aplicación, puedes elegir un modelo dentro de la plataforma y empezar a usar la ayuda de IA para análisis de código, desarrollo de funciones, corrección de errores y revisiones. Así puedes comenzar con Droid:
Paso 1: Instala y abre Droid
Comienza descargando la Factory App en tu dispositivo y completando la instalación. Después, abre la aplicación e inicia sesión en tu cuenta. Esto te da acceso a Droid y a sus funciones de IA integradas dentro de la app.
Paso 2: Conecta Droid con la carpeta de tu proyecto
Configura tu directorio de trabajo en el código base con el que quieres trabajar. Esto vincula Droid con tu proyecto local para que pueda leer los archivos, entender la estructura del código y respaldar tus tareas de desarrollo con mejor contexto.
Paso 3: Elige un modelo integrado y empieza a dar prompts
Abre el selector de modelos y elige uno de los modelos de IA integrados disponibles en Droid. Una vez seleccionado el modelo, puedes empezar a dar prompts, como pedirle que analice el código base, corrija un error, revise el código o construya una función.
¿Cómo conectar Droid con una API externa?
Conectar Droid con una API externa te da más libertad para trabajar con el modelo que prefieras en lugar de limitarte a las opciones integradas. La configuración se realiza dentro de la CLI de Droid agregando un modelo personalizado al archivo de configuración, y una vez guardado, el modelo queda disponible en el menú /model. Los pasos a continuación usan Kimi como ejemplo sencillo, para que veas cómo funciona toda la configuración, desde la clave de API hasta la selección del modelo:
Paso 1: Obtén una clave de API de Kimi de Moonshot AI
Comienza creando o copiando tu clave de API de Kimi desde Moonshot AI. Necesitarás esta clave porque Droid la usa para conectarse con la API de Kimi y enviar solicitudes a través de tu propia cuenta. Es mejor guardar la clave como una variable de entorno, como MOONSHOT_API_KEY, para poder usarla de forma segura dentro del archivo de configuración.
Paso 2: Abre el archivo de configuración de Droid
A continuación, abre el archivo de configuración donde se agregan los modelos personalizados en Droid CLI. En macOS, la ruta del archivo es ~/.factory/settings.json. En Windows PowerShell, usa %USERPROFILE%\.factory\settings.json. Este es el archivo principal donde Droid lee la configuración de tu modelo personalizado.
Paso 3: Agrega Kimi como modelo personalizado
Dentro de settings.json, agrega Kimi en el arreglo customModels. Esto le indica a Droid qué modelo usar, qué endpoint de API debe llamar, qué formato de proveedor sigue y qué clave de API debe usarse para la autenticación. Si el archivo ya tiene otras configuraciones, no reemplaces todo; solo agrega este objeto de modelo dentro del arreglo customModels existente.
Paso 4: Guarda el archivo y reinicia Droid
Después de agregar la configuración, guarda el archivo y reinicia Droid CLI. Esto asegura que Droid vuelva a cargar la configuración actualizada y reconozca correctamente el nuevo modelo personalizado agregado.
Paso 5: Selecciona el modelo Kimi usando /model dentro de Droid
Abre Droid CLI y ejecuta el comando /model. Tu configuración de Kimi debería aparecer ahora en la sección Custom models. Selecciónala de la lista para que Kimi sea el modelo activo en tu sesión de programación.
Paso 6: Ejecuta una tarea
Una vez que Kimi esté seleccionado, puedes empezar a usarlo para trabajo real en Droid. Prueba con un prompt como revisar código, corregir un error o explicar una base de código. Droid enviará la solicitud a través de la Kimi API y usará ese modelo para la tarea.
Beneficios de usar la Kimi API
Después de conectar Kimi a Droid, se convierte en algo mucho más que un modelo externo en la CLI. Se transforma en un asistente de programación práctico que se integra en tu flujo de trabajo diario y ayuda tanto con tareas de codificación pequeñas como con proyectos de ingeniería más grandes. Aquí tienes algunos beneficios de usar la Kimi API:
Aumenta la eficiencia de desarrollo
Kimi puede ayudarte a avanzar más rápido en las tareas cotidianas de programación, generando código, explicando la lógica y sugiriendo correcciones mientras trabajas. Esto significa que no necesitas cambiar entre varias herramientas para obtener soporte básico de desarrollo. Con Kimi dentro de Droid, el trabajo de programación rutinario se vuelve más rápido de manejar.
Escribe código más confiable
Kimi puede revisar tu código, señalar posibles problemas y ayudar a mejorar la estructura antes de que pequeños errores se conviertan en problemas más grandes. Este tipo de retroalimentación temprana es útil cuando quieres una lógica más limpia y mejor mantenibilidad. Con el tiempo, puede ayudarte a construir código más fácil de probar, actualizar y entender.
Maneja diversas tareas de desarrollo
Kimi no se limita a escribir código desde cero. También puede ayudar con la refactorización, la documentación de código, la comprensión de proyectos poco familiares y el soporte al desarrollo de funciones en diferentes tareas. Esto lo convierte en una opción flexible para los desarrolladores que quieren un solo modelo de IA que ayude en muchas partes del flujo de trabajo.
Solución de errores comunes al conectar APIs
Conectar una API key externa en Droid suele ser sencillo, pero pequeños errores de configuración aún pueden causar problemas. La mayoría de los problemas provienen del archivo de configuración, el nombre del proveedor, la API key o la configuración del servidor del modelo, y no de Droid en sí. La parte buena es que estos errores suelen ser fáciles de solucionar una vez que sabes dónde buscar.
El modelo no aparece en el selector
Revisa la sintaxis JSON en
~/.factory/settings.jsonoconfig.jsonsi estás usando el formato antiguoLos cambios en la configuración se detectan automáticamente mediante la supervisión de archivos
Verifica que todos los campos requeridos estén presentes en la configuración del modelo personalizado
Error "Invalid provider"
Asegúrate de que el valor del proveedor sea exactamente
anthropic,openaiogeneric-chat-completion-apiRevisa que no haya errores de escritura ni de mayúsculas y minúsculas en el campo del proveedor
Errores de autenticación
Verifica que tu API key sea válida y tenga créditos disponibles
Comprueba que la API key tenga los permisos correctos para el proveedor
Confirma que la URL base coincida con el endpoint de la API en la documentación del proveedor
El modelo local no se conecta
Asegúrate de que tu servidor de modelo local esté en ejecución, como
ollama serveVerifica que la URL base sea correcta e incluya
/v1/si el proveedor lo requiereComprueba que el modelo ya se haya descargado o esté disponible localmente
Errores de límite de tasa o cuota
Revisa los límites de tasa de la API y las cuotas de uso de tu proveedor
Supervisa tu uso desde el panel del proveedor para ver si se han alcanzado los límites
Conclusión
Usar APIs personalizadas en Droid te da más control sobre cómo construyes, pruebas y mejoras código con IA. Una vez que la configuración está lista, resulta más fácil adaptar tu flujo de trabajo de programación al modelo que se ajuste a tus necesidades. Ya sea que te quedes con las opciones integradas o conectes un modelo externo, Droid te ofrece una forma flexible de incorporar IA al desarrollo. Si quieres un punto de partida simple para una configuración personalizada, vale la pena probar Kimi en Droid. Puede ser una opción práctica para hacer que el trabajo diario de programación sea más fluido y rápido.