Configuration de l'API Droid : comment connecter des modèles d'IA personnalisés

Droid prend en charge les modèles d'IA intégrés et externes, ce qui vous offre davantage de flexibilité pour vos tâches de programmation. Ce guide vous explique comment connecter une API externe, configurer votre environnement, résoudre les problèmes courants et utiliser Kimi pour le développement assisté par IA. Remarque : les modèles personnalisés sont pris en charge dans la CLI de Droid et l'application de bureau Factory (via le fichier local settings.json), mais pas sur les plateformes web ou mobiles hébergées par Factory.

10 min de lectureMis à jour : 2026-09-28
Comment connecter Kimi API à Droid

Vous souhaitez utiliser votre propre modèle d'IA pour programmer sans configuration complexe ? Droid simplifie cette démarche en prenant en charge les API externes dans sa CLI : vous pouvez ainsi connecter un modèle personnalisé adapté à votre flux de travail. Ce guide vous montre comment configurer l'API, résoudre les problèmes courants et utiliser Kimi dans Droid. Poursuivez votre lecture pour commencer.

Qu'est-ce que Droid ?

Droid est un outil de programmation basé sur l'IA qui aide les développeurs à écrire du code, résoudre des erreurs et gérer plus efficacement les tâches de développement. Il prend en charge des modèles d'IA intégrés et permet également aux utilisateurs de connecter des modèles personnalisés via sa CLI pour plus de flexibilité. Il s'adapte ainsi à différents flux de travail de programmation, que vous ayez besoin d'une aide rapide ou d'une configuration plus personnalisée.

Comment utiliser les modèles d'IA intégrés dans Droid ?

Les modèles d'IA intégrés permettent de commencer facilement à programmer avec Droid, car vous n'avez pas besoin de vous connecter d'abord à une API externe. Une fois l'application installée, vous pouvez choisir un modèle dans la plateforme et commencer à utiliser l'assistance IA pour analyser le code, développer des fonctionnalités, corriger des bugs et effectuer des revues. Voici comment démarrer avec Droid :

Étape 1 : Installer et ouvrir Droid

Commencez par télécharger l'application Factory sur votre appareil et terminez l'installation. Ouvrez ensuite l'application et connectez-vous à votre compte. Vous accéderez ainsi à Droid et à ses fonctionnalités d'IA intégrées dans l'application.

Installer et ouvrir Droid

Étape 2 : Connecter Droid au dossier de votre projet

Définissez votre répertoire de travail sur le code source du projet sur lequel vous souhaitez travailler. Droid sera ainsi relié à votre projet local afin de pouvoir lire les fichiers, comprendre la structure du code et vous aider dans vos tâches de développement avec un meilleur contexte.

Connecter Droid au dossier de votre projet

Étape 3 : Choisir un modèle intégré et commencer à saisir des prompts

Ouvrez le sélecteur de modèles et choisissez l'un des modèles d'IA intégrés disponibles dans Droid. Une fois le modèle sélectionné, vous pouvez commencer à lui soumettre des prompts, par exemple pour analyser le code source, corriger un bug, effectuer une revue de code ou développer une fonctionnalité.

Choisir un modèle intégré et commencer à saisir des prompts

Comment connecter Droid à une API externe ?

Connecter Droid à une API externe vous donne plus de liberté pour travailler avec le modèle de votre choix, plutôt que de vous limiter aux options intégrées. La configuration s'effectue dans la CLI de Droid en ajoutant un modèle personnalisé au fichier de paramètres ; une fois le fichier enregistré, le modèle devient disponible dans le menu /model. Les étapes ci-dessous utilisent Kimi comme exemple simple afin de vous montrer l'ensemble du processus, de la clé API à la sélection du modèle :

Étape 1 : Obtenir une clé Kimi API auprès de Moonshot AI

Commencez par créer ou copier votre clé Kimi API depuis Moonshot AI. Vous aurez besoin de cette clé, car Droid l'utilise pour se connecter à Kimi API et envoyer des requêtes via votre propre compte. Il est préférable d'enregistrer la clé dans une variable d'environnement telle que MOONSHOT_API_KEY afin de l'utiliser en toute sécurité dans le fichier de paramètres.

Obtenir une clé Kimi API auprès de Moonshot AI

Étape 2 : Ouvrir le fichier de paramètres de Droid

Ouvrez ensuite le fichier de paramètres dans lequel les modèles personnalisés sont ajoutés dans la CLI de Droid. Sur macOS, le chemin du fichier est ~/.factory/settings.json. Dans Windows PowerShell, utilisez %USERPROFILE%\.factory\settings.json. Il s'agit du fichier principal dans lequel Droid lit la configuration de vos modèles personnalisés.

Étape 3 : Ajouter Kimi en tant que modèle personnalisé

Dans settings.json, ajoutez Kimi au tableau customModels. Vous indiquez ainsi à Droid quel modèle utiliser, quel point de terminaison d'API appeler, quel format de fournisseur il suit et quelle clé API utiliser pour l'authentification. Si le fichier contient déjà d'autres paramètres, ne remplacez pas tout : ajoutez simplement cet objet de modèle dans le tableau customModels existant.

```json { "customModels": [ { "model": "kimi-k3", "displayName": "Kimi K3", "baseUrl": "https://api.moonshot.ai/v1", "apiKey": "${MOONSHOT_API_KEY}", "provider": "generic-chat-completion-api", "maxOutputTokens": 16384 } ] } ```

Étape 4 : Enregistrer le fichier et redémarrer Droid

Après avoir ajouté la configuration, enregistrez le fichier et redémarrez la CLI de Droid. Droid rechargera ainsi les paramètres mis à jour et reconnaîtra correctement le nouveau modèle personnalisé.

Étape 5 : Sélectionner le modèle Kimi avec /model dans Droid

Ouvrez le CLI Droid et exécutez la commande /model. Votre configuration Kimi devrait désormais apparaître dans la section des modèles personnalisés. Sélectionnez-la dans la liste pour faire de Kimi le modèle actif de votre session de codage.

Étape 6 : Exécuter une tâche

Une fois Kimi sélectionné, vous pouvez commencer à l'utiliser pour des tâches concrètes dans Droid. Essayez un prompt, par exemple pour réviser du code, corriger un bug ou expliquer une base de code. Droid enverra la demande via la Kimi API et utilisera ce modèle pour la tâche.

Avantages de la Kimi API

Après avoir connecté Kimi à Droid, il devient bien plus qu'un simple modèle externe dans le CLI. Il se transforme en assistant de codage pratique, adapté à votre flux de développement quotidien, qui vous aide aussi bien pour de petites tâches de programmation que pour des travaux d'ingénierie plus importants. Voici quelques avantages de la Kimi API :

  • Améliorer l'efficacité du développement

Kimi peut vous aider à accomplir plus rapidement les tâches de codage quotidiennes en générant du code, en expliquant la logique et en suggérant des correctifs pendant que vous travaillez. Vous n'avez donc pas besoin de passer d'un outil à l'autre pour une aide au développement simple. Avec Kimi dans Droid, les tâches de programmation courantes sont plus rapides à gérer.

  • Écrire du code plus fiable

Kimi peut réviser votre code, signaler d'éventuels problèmes et vous aider à améliorer sa structure avant que de petites erreurs ne deviennent des problèmes plus importants. Ce type de retour précoce est utile si vous recherchez une logique plus claire et une meilleure maintenabilité. Au fil du temps, il peut vous aider à créer du code plus facile à tester, à mettre à jour et à comprendre.

  • Gérer diverses tâches de développement

Kimi ne se limite pas à écrire du code à partir de zéro. Il peut aussi vous aider à refactoriser, documenter du code, comprendre des projets inconnus et accompagner le développement de fonctionnalités dans différentes tâches. C'est donc une option flexible pour les développeurs qui souhaitent qu'un seul modèle d'IA les assiste dans de nombreuses étapes de leur flux de travail.

Résoudre les erreurs courantes lors de la connexion aux API

La connexion d'une clé API externe dans Droid est généralement simple, mais de petites erreurs de configuration peuvent tout de même poser problème. La plupart des problèmes proviennent du fichier de paramètres, du nom du fournisseur, de la clé API ou de la configuration du serveur de modèles, plutôt que de Droid lui-même. La bonne nouvelle est que ces erreurs sont souvent faciles à corriger une fois que vous savez où chercher.

Le modèle n'apparaît pas dans le sélecteur

  • Vérifiez la syntaxe JSON dans ~/.factory/settings.json ou config.json si vous utilisez le format hérité

  • Les modifications des paramètres sont détectées automatiquement grâce à la surveillance des fichiers

  • Vérifiez que tous les champs requis sont présents dans la configuration du modèle personnalisé

Erreur « Invalid provider »

  • Assurez-vous que la valeur du fournisseur est exactement anthropic, openai ou generic-chat-completion-api

  • Vérifiez l'absence de fautes d'orthographe et la casse correcte dans le champ du fournisseur

Erreurs d'authentification

  • Vérifiez que votre clé API est valide et qu'elle dispose de crédits disponibles

  • Vérifiez que la clé API dispose des autorisations appropriées pour le fournisseur

  • Confirmez que l'URL de base correspond au point de terminaison de l'API indiqué dans la documentation du fournisseur

Le modèle local ne se connecte pas

  • Assurez-vous que votre serveur de modèles local est en cours d'exécution, par exemple avec ollama serve

  • Vérifiez que l'URL de base est correcte et qu'elle inclut /v1/ si le fournisseur l'exige

  • Vérifiez que le modèle a déjà été téléchargé ou qu'il est disponible localement

Erreurs de limitation de débit ou de quota

  • Vérifiez les limites de débit de l'API et les quotas d'utilisation de votre fournisseur

  • Surveillez votre utilisation dans le tableau de bord du fournisseur pour voir si les limites ont été atteintes

Conclusion

L'utilisation d'API personnalisées dans Droid vous donne davantage de contrôle sur la façon dont vous créez, testez et améliorez du code avec l'IA. Une fois la configuration en place, il devient plus simple d'adapter votre flux de travail de codage au modèle qui répond à vos besoins. Que vous restiez avec les options intégrées ou que vous connectiez un modèle externe, Droid offre une manière flexible d'intégrer l'IA au développement. Si vous cherchez un point de départ simple pour une configuration personnalisée, Kimi mérite d'être essayé dans Droid. Il peut constituer un choix pratique pour rendre le travail de codage quotidien plus fluide et plus rapide.

FAQ

Droid prend en charge les modèles d'IA intégrés ainsi que les modèles personnalisés ajoutés via sa CLI. La configuration externe fonctionne avec des types de fournisseurs tels qu'Anthropic, OpenAI et les API génériques de complétion de chat. Les utilisateurs peuvent ainsi travailler avec des API officielles, certains fournisseurs open source ou des modèles locaux, selon leur configuration.
Pour configurer une API externe dans Droid, vous avez généralement besoin de l'identifiant du modèle, de son nom d'affichage, de l'URL de base, de la clé API et du type de fournisseur. Certaines configurations peuvent également inclure des champs facultatifs, tels que le nombre maximal de tokens de sortie, des arguments supplémentaires ou des en-têtes supplémentaires. Ces informations permettent à Droid de se connecter correctement au modèle.
Oui, Droid vous permet de basculer entre les modèles intégrés et externes. Les modèles intégrés peuvent être sélectionnés dans l'application, tandis que les modèles personnalisés peuvent être choisis dans le menu /model de la CLI après configuration. Vous pouvez ainsi utiliser différents modèles selon les tâches de programmation.
Cela signifie généralement que votre fournisseur d'API a atteint une limite d'utilisation, un plafond de requêtes ou un quota de facturation. Consultez le tableau de bord de votre fournisseur pour vérifier les crédits, l'utilisation et les limites de débit. Une fois le problème de limite résolu, le modèle devrait à nouveau fonctionner dans Droid sans autre modification de la configuration.
Vous pourriez aussi aimer
10 plateformes populaires de création d'agents IA pour concevoir des workflows IA
10 plateformes populaires de création d'agents IA pour concevoir des workflows IA
2026-09-28
Guide d'intégration de Trae API pour le développement avec l'IA
Guide d'intégration de Trae API pour le développement avec l'IA
2026-09-28
Guide n8n AI Agent : créer et automatiser des workflows
Guide n8n AI Agent : créer et automatiser des workflows
2026-09-28
Installer Claude Code : guide complet pour Windows et Mac
Installer Claude Code : guide complet pour Windows et Mac
2026-09-28
Comment connecter une API externe à Kilo Code
Comment connecter une API externe à Kilo Code
2026-09-28