Droid API-Setup: So verbindest du benutzerdefinierte KI-Modelle

Droid unterstützt sowohl integrierte als auch externe KI-Modelle, was dir mehr Flexibilität bei Coding-Aufgaben gibt. Diese Anleitung führt dich durch das Verbinden einer externen API, das Konfigurieren deines Setups, die Behebung häufiger Probleme und die Nutzung von Kimi für KI-gestützte Entwicklung. Hinweis: Diese Anleitung gilt nur für die Droid CLI. Benutzerdefinierte Modelle werden derzeit nur in der CLI unterstützt und sind in anderen Droid-Produkten nicht verfügbar.

Droid mit der Kimi API verbinden

10 Min. Lesezeit2026-08-12

Möchtest du dein eigenes KI-Modell für das Coding nutzen, ohne eine komplizierte Einrichtung? Droid macht das einfacher, indem es externe APIs in seiner CLI unterstützt, sodass du ein benutzerdefiniertes Modell verbinden kannst, das zu deinem Workflow passt. Diese Anleitung zeigt dir, wie du die API einrichtest, häufige Probleme behebst und Kimi in Droid nutzt. Lies weiter, um zu starten.

Was ist Droid?

Droid ist ein KI-Coding-Tool, das Entwicklern hilft, Code zu schreiben, Fehler zu lösen und Entwicklungsaufgaben effizienter zu erledigen. Es unterstützt integrierte KI-Modelle und ermöglicht es Nutzern außerdem, über die CLI benutzerdefinierte Modelle zu verbinden, für mehr Flexibilität. Das macht es nützlich für unterschiedliche Coding-Workflows, egal ob du schnelle Hilfe oder ein individuelleres Setup brauchst.

Wie nutzt man integrierte KI-Modelle in Droid?

Integrierte KI-Modelle machen den Einstieg in Droid einfach, da du dich zunächst nicht mit einer externen API verbinden musst. Sobald die App installiert ist, kannst du ein Modell direkt in der Plattform auswählen und mit KI-Unterstützung für Code-Analyse, Feature-Arbeit, Bugfixes und Reviews beginnen. So kommst du mit Droid los:

Schritt 1: Droid installieren und öffnen

Lade zunächst die Factory App auf deinem Gerät herunter und schließe die Installation ab. Öffne danach die App und melde dich bei deinem Konto an. So erhältst du Zugriff auf Droid und seine integrierten KI-Funktionen innerhalb der App.

Schritt 2: Droid mit deinem Projektordner verbinden

Setze dein Arbeitsverzeichnis auf die Codebasis, an der du arbeiten möchtest. Dadurch wird Droid mit deinem lokalen Projekt verknüpft, sodass es die Dateien lesen, die Codestruktur verstehen und deine Entwicklungsaufgaben mit besserem Kontext unterstützen kann.

Schritt 3: Ein integriertes Modell auswählen und mit dem Prompten beginnen

Öffne die Modellauswahl und wähle eines der in Droid verfügbaren integrierten KI-Modelle. Sobald das Modell ausgewählt ist, kannst du Prompts eingeben, zum Beispiel um die Codebasis analysieren zu lassen, einen Bug zu beheben, Code zu überprüfen oder ein Feature zu bauen.

Wie verbindet man Droid mit einer externen API?

Wenn du Droid mit einer externen API verbindest, hast du mehr Freiheit, mit dem Modell deiner Wahl zu arbeiten, statt auf integrierte Optionen beschränkt zu sein. Die Einrichtung erfolgt innerhalb der Droid CLI, indem ein benutzerdefiniertes Modell zur Einstellungsdatei hinzugefügt wird. Sobald das gespeichert ist, wird das Modell über das /model-Menü verfügbar. Die folgenden Schritte nutzen Kimi als einfaches Beispiel, damit du sehen kannst, wie die gesamte Einrichtung vom API-Schlüssel bis zur Modellauswahl funktioniert:

Schritt 1: Einen Kimi API-Schlüssel von Moonshot AI holen

Erstelle oder kopiere zunächst deinen Kimi API-Schlüssel von Moonshot AI. Du benötigst diesen Schlüssel, da Droid ihn verwendet, um sich mit der Kimi API zu verbinden und Anfragen über dein eigenes Konto zu senden. Am besten speicherst du den Schlüssel als Umgebungsvariable wie MOONSHOT_API_KEY, damit er sicher innerhalb der Einstellungsdatei verwendet werden kann.

Schritt 2: Die Droid-Einstellungsdatei öffnen

Öffne als Nächstes die Einstellungsdatei, in der benutzerdefinierte Modelle in der Droid CLI hinzugefügt werden. Auf macOS lautet der Dateipfad ~/.factory/settings.json. In der Windows PowerShell verwende %USERPROFILE%\.factory\settings.json. Dies ist die Hauptdatei, aus der Droid deine benutzerdefinierte Modellkonfiguration liest.

Schritt 3: Kimi als benutzerdefiniertes Modell hinzufügen

Füge Kimi innerhalb von settings.json unter dem Array customModels hinzu. Das teilt Droid mit, welches Modell verwendet werden soll, welchen API-Endpunkt es aufrufen soll, welchem Anbieterformat es folgt und welcher API-Schlüssel für die Authentifizierung verwendet werden soll. Falls die Datei bereits andere Einstellungen enthält, ersetze nicht alles, sondern füge dieses Modellobjekt einfach innerhalb des bestehenden customModels-Arrays hinzu.

```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 } ] } ```

Schritt 4: Datei speichern und Droid neu starten

Nachdem du die Konfiguration hinzugefügt hast, speichere die Datei und starte die Droid CLI neu. So stellst du sicher, dass Droid die aktualisierten Einstellungen neu lädt und das neu hinzugefügte benutzerdefinierte Modell korrekt erkennt.

Schritt 5: Das Kimi-Modell über /model in Droid auswählen

Öffne die Droid CLI und führe den Befehl /model aus. Dein Kimi-Setup sollte jetzt im Bereich Custom models erscheinen. Wähle es aus der Liste aus, um Kimi zum aktiven Modell für deine Coding-Session zu machen.

Schritt 6: Eine Aufgabe ausführen

Sobald Kimi ausgewählt ist, kannst du es für echte Arbeit in Droid nutzen. Probiere einen Prompt aus, etwa zum Überprüfen von Code, Beheben eines Bugs oder Erklären einer Codebasis. Droid sendet die Anfrage über die Kimi API und nutzt dieses Modell für die Aufgabe.

Vorteile der Nutzung der Kimi API

Nachdem Kimi mit Droid verbunden ist, wird es zu weit mehr als nur einem externen Modell in der CLI. Es wird zu einem praktischen Coding-Assistenten, der sich in deinen täglichen Entwicklungsworkflow einfügt und bei kleinen Coding-Aufgaben ebenso hilft wie bei größeren Engineering-Aufgaben. Hier sind einige Vorteile der Nutzung der Kimi API:

Entwicklungseffizienz steigern

Kimi kann dir helfen, alltägliche Coding-Aufgaben schneller zu bewältigen, indem es Code generiert, Logik erklärt und während der Arbeit Korrekturen vorschlägt. Das bedeutet, dass du für einfache Entwicklungsunterstützung nicht zwischen mehreren Tools wechseln musst. Mit Kimi in Droid lässt sich Routine-Programmierarbeit schneller erledigen.

Zuverlässigeren Code schreiben

Kimi kann deinen Code überprüfen, mögliche Probleme aufzeigen und helfen, die Struktur zu verbessern, bevor kleine Fehler zu größeren Problemen werden. Dieses frühe Feedback ist nützlich, wenn du sauberere Logik und bessere Wartbarkeit anstrebst. Mit der Zeit kann es dir helfen, Code zu schreiben, der leichter zu testen, zu aktualisieren und zu verstehen ist.

Vielfältige Entwicklungsaufgaben bewältigen

Kimi ist nicht darauf beschränkt, Code von Grund auf zu schreiben. Es kann auch bei Refactoring, Dokumentation von Code, dem Verstehen unbekannter Projekte und der Unterstützung der Feature-Entwicklung über verschiedene Aufgaben hinweg helfen. Das macht es zu einer flexiblen Option für Entwickler, die ein KI-Modell für viele Teile ihres Workflows nutzen möchten.

Fehlerbehebung bei häufigen Fehlern bei der API-Verbindung

Das Verbinden eines externen API-Schlüssels in Droid ist normalerweise unkompliziert, aber kleine Einrichtungsfehler können trotzdem Probleme verursachen. Die meisten Probleme entstehen durch die Settings-Datei, den Provider-Namen, den API-Schlüssel oder die Konfiguration des Model-Servers und nicht durch Droid selbst. Das Gute ist, dass diese Fehler oft leicht zu beheben sind, sobald man weiß, wo man nachsehen muss.

Modell erscheint nicht im Selector

Überprüfe die JSON-Syntax in ~/.factory/settings.json oder config.json, falls du das ältere Format verwendest
Änderungen an den Einstellungen werden durch File Watching automatisch erkannt
Stelle sicher, dass alle erforderlichen Felder in der Custom-Model-Konfiguration vorhanden sind

Fehler „Invalid provider“

Stelle sicher, dass der Provider-Wert genau anthropic, openai oder generic-chat-completion-api lautet
Achte auf Rechtschreibfehler und korrekte Groß-/Kleinschreibung im Provider-Feld

Authentifizierungsfehler

Überprüfe, ob dein API-Schlüssel gültig ist und noch Guthaben verfügbar ist
Überprüfe, ob der API-Schlüssel die richtigen Berechtigungen für den Provider hat
Bestätige, dass die Base URL mit dem API-Endpunkt in der Dokumentation des Providers übereinstimmt

Lokales Modell verbindet sich nicht

Stelle sicher, dass dein lokaler Model-Server läuft, etwa mit ollama serve
Überprüfe, ob die Base URL korrekt ist und /v1/ enthält, falls der Provider dies erfordert
Überprüfe, ob das Modell bereits heruntergeladen wurde oder lokal verfügbar ist

Fehler wegen Rate Limiting oder Kontingent

Überprüfe die API-Ratenlimits und Nutzungskontingente deines Providers
Überwache deine Nutzung im Provider-Dashboard, um zu sehen, ob Limits erreicht wurden

Fazit

Die Nutzung benutzerdefinierter APIs in Droid gibt dir mehr Kontrolle darüber, wie du mit KI Code baust, testest und verbesserst. Sobald die Einrichtung steht, lässt sich der Coding-Workflow leichter an das Modell anpassen, das zu deinen Bedürfnissen passt. Egal ob du bei den integrierten Optionen bleibst oder ein externes Modell verbindest, Droid bietet dir eine flexible Möglichkeit, KI in die Entwicklung einzubinden. Wenn du eine einfache Ausgangsbasis für ein individuelles Setup suchst, lohnt es sich, Kimi in Droid auszuprobieren. Es kann eine praktische Wahl sein, um die alltägliche Coding-Arbeit reibungsloser und schneller zu machen.

Droid mit der Kimi API verbinden

FAQ

Welche KI-Modelle unterstützt Droid?

Droid unterstützt sowohl integrierte KI-Modelle als auch benutzerdefinierte Modelle, die über die CLI hinzugefügt werden. Die externe Einrichtung funktioniert mit Anbietertypen wie Anthropic, OpenAI und generischen Chat-Completion-APIs. Das gibt Nutzern die Flexibilität, mit offiziellen APIs, einigen Open-Source-Anbietern oder lokalen Modellen zu arbeiten, je nach Setup.

Welche Angaben werden benötigt, um eine externe API zu konfigurieren?

Um eine externe API in Droid zu konfigurieren, benötigst du üblicherweise die Modell-ID, den Anzeigenamen, die Base-URL, den API-Schlüssel und den Anbietertyp. Manche Setups enthalten außerdem optionale Felder wie maximale Ausgabe-Token, zusätzliche Argumente oder zusätzliche Header. Diese Angaben helfen Droid, sich korrekt mit dem Modell zu verbinden.

Kann ich zwischen integrierten und externen KI-Modellen wechseln?

Ja, mit Droid kannst du zwischen integrierten und externen Modellen wechseln. Integrierte Modelle können in der App ausgewählt werden, während benutzerdefinierte Modelle nach der Einrichtung über das /model-Menü in der CLI ausgewählt werden können. So lassen sich für unterschiedliche Coding-Aufgaben leicht verschiedene Modelle nutzen.

Warum sehe ich einen Rate-Limit- oder Kontingentfehler?

Das bedeutet üblicherweise, dass dein API-Anbieter ein Nutzungslimit, eine Anfragebeschränkung oder ein Abrechnungskontingent erreicht hat. Prüfe im Dashboard deines Anbieters Guthaben, Nutzung und Rate Limits. Sobald das Limit-Problem behoben ist, sollte das Modell in Droid wieder funktionieren, ohne dass weitere Konfigurationsänderungen nötig sind.

Das könnte Ihnen auch gefallen