Droid API kurulumu: Özel AI modelleri nasıl bağlanır?

Droid, hem yerleşik hem de harici AI modellerini destekleyerek kodlama görevlerinde daha fazla esneklik sunar. Bu rehber; harici bir API'yi bağlama, kurulumu yapılandırma, yaygın sorunları giderme ve AI destekli geliştirmede Kimi'yi kullanma adımlarını açıklar. Not: Özel modeller Droid CLI ve Factory masaüstü uygulamasında (yerel settings.json üzerinden) desteklenir; ancak Factory'nin barındırılan web veya mobil platformlarında desteklenmez.

10 dakikalık okumaGüncellendi: 2026-09-28
Kimi API, Droid'a nasıl bağlanır?

Karmaşık bir kurulum olmadan kendi AI modelinizi kodlama için kullanmak mı istiyorsunuz? Droid, CLI'sinde harici API'leri destekleyerek iş akışınıza uygun özel bir model bağlamanızı kolaylaştırır. Bu rehberde API'yi nasıl kuracağınızı, yaygın sorunları nasıl çözeceğinizi ve Kimi'yi Droid'da nasıl kullanacağınızı göreceksiniz. Başlamak için okumaya devam edin.

Droid nedir?

Droid, geliştiricilerin kod yazmasına, hataları çözmesine ve geliştirme görevlerini daha verimli yürütmesine yardımcı olan bir AI kodlama aracıdır. Yerleşik AI modellerini destekler ve daha fazla esneklik için kullanıcıların CLI üzerinden özel modeller bağlamasına da olanak tanır. İster hızlı yardıma ister daha kişiselleştirilmiş bir kuruluma ihtiyacınız olsun, farklı kodlama iş akışları için kullanışlıdır.

Droid'da yerleşik AI modelleri nasıl kullanılır?

Yerleşik AI modelleri, önce herhangi bir harici API'ye bağlanmanız gerekmediği için Droid ile kodlamaya başlamayı kolaylaştırır. Uygulama yüklendikten sonra platform içinden bir model seçip kod analizi, özellik geliştirme, hata düzeltme ve inceleme için AI yardımını kullanmaya başlayabilirsiniz. Droid'a başlamak için şu adımları izleyin:

1. Adım: Droid'u yükleyin ve açın

Önce cihazınıza Factory App'i indirin ve yüklemeyi tamamlayın. Ardından uygulamayı açıp hesabınızda oturum açın. Böylece uygulama içindeki Droid'a ve yerleşik AI özelliklerine erişebilirsiniz.

Droid'u yükleyin ve açın

2. Adım: Droid'u proje klasörünüze bağlayın

Çalışma dizininizi üzerinde çalışmak istediğiniz kod tabanına ayarlayın. Bu, Droid'u yerel projenize bağlayarak dosyaları okumasını, kod yapısını anlamasını ve geliştirme görevlerinize daha iyi bağlamla destek vermesini sağlar.

Droid'u proje klasörünüze bağlayın

3. Adım: Yerleşik bir model seçin ve prompt girmeye başlayın

Model seçiciyi açın ve Droid'da bulunan yerleşik AI modellerinden birini seçin. Model seçildikten sonra kod tabanını analiz etmesini istemek, bir hatayı düzeltmek, kodu incelemek veya bir özellik geliştirmek gibi prompt'lar girmeye başlayabilirsiniz.

Yerleşik bir model seçin ve prompt girmeye başlayın

Droid harici bir API'ye nasıl bağlanır?

Droid'u harici bir API'ye bağlamak, yerleşik seçeneklerle sınırlı kalmak yerine tercih ettiğiniz modelle çalışma özgürlüğü sağlar. Kurulum, ayarlar dosyasına özel bir model eklenerek Droid CLI içinde yapılır; kaydedildiğinde model /model menüsünden kullanılabilir hâle gelir. Aşağıdaki adımlar, API anahtarından model seçimine kadar tüm kurulumun nasıl çalıştığını görebilmeniz için Kimi'yi basit bir örnek olarak kullanır:

1. Adım: Moonshot AI'den Kimi API anahtarı alın

Moonshot AI'den Kimi API anahtarınızı oluşturun veya kopyalayın. Droid, Kimi API'ye bağlanmak ve kendi hesabınız üzerinden istek göndermek için bu anahtarı kullanır. Anahtarı ayarlar dosyasında güvenli şekilde kullanabilmek için MOONSHOT_API_KEY gibi bir ortam değişkeni olarak kaydetmeniz önerilir.

Moonshot AI'den Kimi API anahtarı alın

2. Adım: Droid ayarlar dosyasını açın

Ardından, Droid CLI'da özel modellerin eklendiği ayarlar dosyasını açın. macOS'te dosya yolu ~/.factory/settings.json şeklindedir. Windows PowerShell'de %USERPROFILE%\.factory\settings.json kullanın. Bu, Droid'un özel model yapılandırmanızı okuduğu ana dosyadır.

3. Adım: Kimi'yi özel model olarak ekleyin

settings.json içinde Kimi'yi customModels dizisinin altına ekleyin. Bu, Droid'a hangi modeli kullanacağını, hangi API uç noktasını çağıracağını, hangi sağlayıcı biçimini izlediğini ve kimlik doğrulama için hangi API anahtarının kullanılacağını bildirir. Dosyada başka ayarlar zaten varsa her şeyi değiştirmeyin; yalnızca bu model nesnesini mevcut customModels dizisinin içine ekleyin.

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

4. Adım: Dosyayı kaydedin ve Droid'u yeniden başlatın

Yapılandırmayı ekledikten sonra dosyayı kaydedin ve Droid CLI'yi yeniden başlatın. Böylece Droid güncellenen ayarları yeniden yükler ve yeni eklenen özel modeli doğru şekilde tanır.

5. Adım: Droid içinde /model kullanarak Kimi modelini seçin

Droid CLI'yi açın ve /model komutunu çalıştırın. Kimi kurulumunuz artık Custom models bölümünde görünmelidir. Kodlama oturumunuzda Kimi'yi etkin model yapmak için listeden seçin.

6. Adım: Bir görev çalıştırın

Kimi'yi seçtikten sonra Droid'da gerçek işler için kullanmaya başlayabilirsiniz. Kod inceleme, hata düzeltme veya bir kod tabanını açıklama gibi bir prompt deneyin. Droid, isteği Kimi API aracılığıyla gönderir ve görev için bu modeli kullanır.

Kimi API kullanmanın avantajları

Kimi'yi Droid'a bağladıktan sonra, CLI içindeki harici bir modelden çok daha fazlası hâline gelir. Günlük geliştirme iş akışınıza uyum sağlayan, küçük kodlama işlerinde ve daha büyük mühendislik görevlerinde yardımcı olan pratik bir kodlama asistanına dönüşür. Kimi API kullanmanın bazı avantajları şunlardır:

  • Geliştirme verimliliğini artırın

Kimi; kod üreterek, mantığı açıklayarak ve çalışırken düzeltme önerileri sunarak günlük kodlama görevlerini daha hızlı tamamlamanıza yardımcı olabilir. Böylece basit geliştirme desteği için birden fazla araç arasında geçiş yapmanız gerekmez. Kimi Droid içinde olduğunda, rutin programlama işlerini yönetmek hızlanır.

  • Daha güvenilir kod yazın

Kimi, küçük hatalar daha büyük sorunlara dönüşmeden önce kodunuzu inceleyebilir, olası sorunları belirtebilir ve yapıyı iyileştirmenize yardımcı olabilir. Bu tür erken geri bildirimler, daha temiz mantık ve daha iyi sürdürülebilirlik istediğinizde faydalıdır. Zamanla test edilmesi, güncellenmesi ve anlaşılması daha kolay kodlar oluşturmanıza yardımcı olabilir.

  • Farklı geliştirme görevlerini yönetin

Kimi yalnızca sıfırdan kod yazmakla sınırlı değildir. Ayrıca yeniden düzenleme, kod belgeleme, tanımadığınız projeleri anlama ve farklı görevlerde özellik geliştirmeyi destekleme konularında da yardımcı olabilir. Bu, iş akışının birçok bölümünde yardımcı olması için tek bir AI modeli isteyen geliştiriciler açısından esnek bir seçenek olmasını sağlar.

API'lere bağlanırken sık karşılaşılan hataları giderme

Droid'da harici bir API anahtarı bağlamak genellikle kolaydır, ancak küçük kurulum hataları yine de sorunlara yol açabilir. Sorunların çoğu Droid'ın kendisinden ziyade ayarlar dosyası, sağlayıcı adı, API anahtarı veya model sunucusu yapılandırmasından kaynaklanır. Nerede bakmanız gerektiğini bildiğinizde bu hataları çözmek genellikle kolaydır.

Model seçicide görünmüyor

  • Eski biçimi kullanıyorsanız ~/.factory/settings.json veya config.json içindeki JSON söz dizimini kontrol edin

  • Ayar değişiklikleri, dosya izleme yoluyla otomatik olarak algılanır

  • Özel model yapılandırmasında gerekli tüm alanların bulunduğunu doğrulayın

"Geçersiz sağlayıcı" hatası

  • Sağlayıcı değerinin tam olarak anthropic, openai veya generic-chat-completion-api olduğundan emin olun

  • Sağlayıcı alanında yazım hatası ve yanlış büyük/küçük harf kullanımı olup olmadığını kontrol edin

Kimlik doğrulama hataları

  • API anahtarınızın geçerli olduğunu ve kullanılabilir krediniz bulunduğunu doğrulayın

  • API anahtarının sağlayıcı için doğru izinlere sahip olduğunu kontrol edin

  • Temel URL'nin, sağlayıcının belgelerindeki API uç noktasıyla eşleştiğini doğrulayın

Yerel model bağlanmıyor

  • ollama serve gibi yerel model sunucunuzun çalıştığından emin olun

  • Temel URL'nin doğru olduğunu ve sağlayıcı gerektiriyorsa /v1/ içerdiğini doğrulayın

  • Modelin önceden indirildiğini veya yerel olarak kullanılabilir olduğunu kontrol edin

Hız sınırlaması veya kota hataları

  • Sağlayıcınızın API hız sınırlarını ve kullanım kotalarını kontrol edin

  • Sınırlara ulaşılıp ulaşılmadığını görmek için sağlayıcı kontrol panelinden kullanımınızı izleyin

Sonuç

Droid'da özel API'ler kullanmak, AI ile kod oluşturma, test etme ve iyileştirme süreçleri üzerinde daha fazla kontrol sağlar. Kurulum tamamlandığında, kodlama iş akışınızı ihtiyaçlarınıza uygun model etrafında şekillendirmek kolaylaşır. İster yerleşik seçeneklerle devam edin ister harici bir model bağlayın, Droid AI'ı geliştirme sürecine dahil etmek için esnek bir yol sunar. Özel bir kurulumla başlamak için basit bir seçenek arıyorsanız Kimi'yi Droid'da denemeye değer. Günlük kodlama işlerini daha akıcı ve hızlı hâle getirmek için pratik bir tercih olabilir.

SSS

Droid, yerleşik AI modellerinin yanı sıra CLI üzerinden eklenen özel modelleri de destekler. Harici kurulum; Anthropic, OpenAI ve genel sohbet tamamlama API'leri gibi sağlayıcı türleriyle çalışır. Bu sayede kullanıcılar, kurulumlarına göre resmî API'lerle, bazı açık kaynak sağlayıcılarla veya yerel modellerle çalışma esnekliği kazanır.
Droid'da harici bir API yapılandırmak için genellikle model kimliği, görünen ad, temel URL, API anahtarı ve sağlayıcı türü gerekir. Bazı kurulumlarda maksimum çıktı tokenı, ek bağımsız değişkenler veya ek üstbilgiler gibi isteğe bağlı alanlar da bulunabilir. Bu bilgiler, Droid'un modele doğru şekilde bağlanmasına yardımcı olur.
Evet, Droid yerleşik ve harici modeller arasında geçiş yapmanıza olanak tanır. Yerleşik modeller uygulamada seçilebilir; özel modeller ise kurulumdan sonra CLI'daki /model menüsünden seçilebilir. Bu sayede farklı kodlama görevleri için farklı modelleri kolayca kullanabilirsiniz.
Bu genellikle API sağlayıcınızın bir kullanım sınırına, istek kotasına veya faturalandırma kotasına ulaştığı anlamına gelir. Kredileri, kullanımı ve hız sınırlarını incelemek için sağlayıcınızın kontrol panelini kontrol edin. Sınır sorunu çözüldüğünde, başka bir yapılandırma değişikliğine gerek kalmadan model Droid'da yeniden çalışacaktır.
Bunları da Beğenebilirsiniz
AI İş Akışları Oluşturmak İçin 10 Popüler AI Agent Aracı
AI İş Akışları Oluşturmak İçin 10 Popüler AI Agent Aracı
2026-09-28
AI Geliştirme için Trae API Entegrasyon Rehberi
AI Geliştirme için Trae API Entegrasyon Rehberi
2026-09-28
n8n AI Agent Rehberi: İş Akışları Oluşturma ve Otomatikleştirme
n8n AI Agent Rehberi: İş Akışları Oluşturma ve Otomatikleştirme
2026-09-28
Claude Code Yükleme: Windows ve Mac için Kapsamlı Kılavuz
Claude Code Yükleme: Windows ve Mac için Kapsamlı Kılavuz
2026-09-28
Harici Bir API, Kilo Code'a Nasıl Bağlanır?
Harici Bir API, Kilo Code'a Nasıl Bağlanır?
2026-09-28