Configuración de la API de Droid: cómo conectar modelos de IA personalizados

¿Quieres usar tu propio modelo de IA para programar sin una configuración complicada? Droid lo facilita al admitir API externas en su CLI, para que puedas conectar un modelo personalizado que se adapte a tu flujo de trabajo. Esta guía te muestra cómo configurar la API, resolver problemas comunes y usar Kimi en Droid. Sigue leyendo para comenzar.

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 conectar modelos personalizados mediante su CLI para ofrecer mayor flexibilidad. Esto la hace útil para distintos flujos de trabajo de programación, ya sea que necesites ayuda rápida o una configuración más personalizada.

Los modelos de IA integrados facilitan comenzar a programar con Droid, ya que no necesitas conectarte primero a ninguna API externa. Una vez instalada la app, puedes elegir un modelo dentro de la plataforma y comenzar a usar asistencia de IA para analizar código, desarrollar funciones, corregir errores y realizar revisiones. Así puedes comenzar a usar Droid:

Paso 1: Instala y abre Droid

Comienza descargando Factory App en tu dispositivo y completa la instalación. Después, abre la app 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 a la carpeta de tu proyecto

Establece el directorio de trabajo en la base de código con la que deseas trabajar. Esto vincula Droid con tu proyecto local para que pueda leer los archivos, comprender la estructura del código y brindar soporte para tus tareas de desarrollo con mejor contexto.

Paso 3: Elige un modelo integrado y comienza a usar prompts

Abre el selector de modelos y elige uno de los modelos de IA integrados disponibles en Droid. Una vez seleccionado, puedes empezar a darle prompts, como pedirle que analice la base de código, corrija un error, revise código o desarrolle una función.

Conectar Droid a 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 en la CLI de Droid al agregar un modelo personalizado al archivo de configuración y, una vez guardado, el modelo estará disponible desde el menú /model. Los pasos siguientes 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 Kimi API de Moonshot AI

Comienza creando o copiando tu clave de Kimi API de Moonshot AI. Necesitarás esta clave porque Droid la utiliza para conectarse con Kimi API y enviar solicitudes mediante tu propia cuenta. Es recomendable guardar la clave como una variable de entorno, como MOONSHOT_API_KEY, para poder usarla de forma segura en el 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 modelos personalizados en la CLI de Droid. 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 tus modelos personalizados.

Paso 3: Agrega Kimi como modelo personalizado

Dentro de settings.json, agrega Kimi en el arreglo customModels. Esto indica a Droid qué modelo usar, a qué endpoint de API debe llamar, qué formato de proveedor sigue y qué clave de API debe utilizar 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 la CLI de Droid. Esto garantiza que Droid recargue la configuración actualizada y reconozca correctamente el modelo personalizado recién agregado.

Paso 5: Selecciona el modelo Kimi con /model dentro de Droid

Abre Droid CLI y ejecuta el comando /model. La configuración de Kimi debería aparecer ahora en la sección Modelos personalizados. Selecciónala de la lista para activar Kimi como el modelo de tu sesión de programación.

Paso 6: Ejecuta una tarea

Una vez que selecciones Kimi, puedes empezar a usarlo para trabajo real en Droid. Prueba un prompt para revisar código, corregir un error o explicar una base de código. Droid enviará la solicitud a través de Kimi API y usará ese modelo para la tarea.

Después de conectar Kimi a Droid, se convierte en mucho más que un modelo externo en la CLI. Pasa a ser un asistente práctico de programación que se integra a tu flujo de trabajo diario de desarrollo y ayuda tanto con tareas pequeñas de código como con trabajos de ingeniería más grandes. Estas son algunas ventajas de usar Kimi API:

• Aumenta la eficiencia del desarrollo

Kimi puede ayudarte a avanzar más rápido en las tareas cotidianas de programación al generar código, explicar la lógica y sugerir correcciones mientras trabajas. Así, no necesitas cambiar entre varias herramientas para obtener ayuda básica de desarrollo. Con Kimi dentro de Droid, el trabajo rutinario de programación es más rápido de gestionar.

• Escribe código más confiable

Kimi puede revisar tu código, señalar posibles problemas y ayudarte a mejorar la estructura antes de que pequeños errores se conviertan en problemas mayores. Este tipo de retroalimentación temprana es útil cuando buscas una lógica más clara y mejor mantenibilidad. Con el tiempo, puede ayudarte a crear código más fácil de probar, actualizar y entender.

• Aborda 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 desconocidos y el desarrollo de funcionalidades en distintas tareas. Esto lo convierte en una opción flexible para desarrolladores que quieren un modelo de IA que ayude en muchas partes del flujo de trabajo.

Conectar una clave de API externa en Droid suele ser sencillo, pero pequeños errores de configuración pueden causar problemas. La mayoría de los inconvenientes provienen del archivo de configuración, el nombre del proveedor, la clave de API o la configuración del servidor del modelo, y no de Droid. Lo bueno es que estos errores suelen ser fáciles de corregir una vez que sabes dónde buscar.

• Revisa la sintaxis de JSON en ~/.factory/settings.json o en config.json si usas el formato heredado

• Los cambios en la configuración se detectan automáticamente mediante la supervisión de archivos

• Verifica que todos los campos obligatorios estén presentes en la configuración del modelo personalizado

• Asegúrate de que el valor del proveedor sea exactamente anthropic, openai o generic-chat-completion-api

• Revisa si hay errores ortográficos y el uso correcto de mayúsculas y minúsculas en el campo del proveedor

• Verifica que tu clave de API sea válida y tenga créditos disponibles

• Comprueba que la clave de API 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

• Asegúrate de que el servidor de tu modelo local esté en ejecución, como ollama serve

• Verifica que la URL base sea correcta e incluya /v1/ si el proveedor lo requiere

• Comprueba que el modelo ya se haya descargado o esté disponible localmente

• Revisa los límites de velocidad 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

Usar APIs personalizadas en Droid te da más control sobre cómo creas, pruebas y mejoras código con IA. Una vez configurado, resulta más fácil adaptar tu flujo de trabajo de programación al modelo que mejor se ajuste a tus necesidades. Ya sea que uses las opciones integradas o conectes un modelo externo, Droid te ofrece una forma flexible de incorporar IA al desarrollo. Si buscas un punto de partida sencillo para una configuración personalizada, vale la pena probar Kimi en Droid. Puede ser una opción práctica para que el trabajo cotidiano de programación sea más ágil y rápido.