Droid API Kurulumu: Özel Yapay Zeka Modelleri Nasıl Bağlanır

Droid hem yerleşik hem de harici yapay zeka modellerini destekler, bu da kodlama görevleri için size daha fazla esneklik sağlar. Bu rehber sizi harici bir API'yi bağlama, kurulumunuzu yapılandırma, yaygın sorunları giderme ve yapay zeka destekli geliştirme için Kimi'yi kullanma adımlarında yönlendirir. Not: Bu rehber yalnızca Droid CLI içindir. Özel modeller şu anda yalnızca CLI'de desteklenmektedir ve diğer Droid ürünlerinde kullanılamaz.

Droid'i Kimi API ile Bağlama

10 dakikalık okuma2026-08-12

Karmaşık bir kurulum yapmadan kodlama için kendi yapay zeka modelinizi mi kullanmak istiyorsunuz? Droid, CLI'sinde harici API'leri destekleyerek bunu kolaylaştırır, böylece iş akışınıza uygun özel bir model bağlayabilirsiniz. Bu rehber size API'yi nasıl kuracağınızı, yaygın sorunları nasıl çözeceğinizi ve Droid'de Kimi'yi nasıl kullanacağınızı gösterir. Başlamak için okumaya devam edin.

Droid Nedir?

Droid, geliştiricilerin kod yazmasına, hataları çözmesine ve geliştirme görevlerini daha verimli bir şekilde ele almasına yardımcı olan bir yapay zeka kodlama aracıdır. Yerleşik yapay zeka modellerini destekler ve ayrıca daha fazla esneklik için kullanıcıların CLI üzerinden özel modeller bağlamasına olanak tanır. Bu, ister hızlı yardım ister daha kişiselleştirilmiş bir kurulum isteyin, farklı kodlama iş akışları için onu kullanışlı hale getirir.

Droid'de yerleşik yapay zeka modelleri nasıl kullanılır?

Yerleşik yapay zeka modelleri, önce herhangi bir harici API'ye bağlanmanız gerekmediği için Droid ile kodlamaya başlamayı kolaylaştırır. Uygulama kurulduktan sonra, platform içinden bir model seçebilir ve kod analizi, özellik çalışması, hata düzeltmeleri ve incelemeler için yapay zeka yardımı almaya başlayabilirsiniz. Droid ile başlamak için izlemeniz gereken adımlar:

Adım 1: Droid'i kurun ve açın

Cihazınıza Factory App'i indirerek ve kurulumu tamamlayarak başlayın. Ardından uygulamayı açın ve hesabınızda oturum açın. Bu, uygulama içinde Droid'e ve yerleşik yapay zeka özelliklerine erişmenizi sağlar.

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

Çalışma dizininizi üzerinde çalışmak istediğiniz kod tabanı olarak ayarlayın. Bu, Droid'i yerel projenizle bağlar, böylece dosyaları okuyabilir, kod yapısını anlayabilir ve geliştirme görevlerinizi daha iyi bir bağlamla destekleyebilir.

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

Model seçiciyi açın ve Droid'de mevcut yerleşik yapay zeka modellerinden birini seçin. Model seçildikten sonra, kod tabanını analiz etmesini, bir hatayı düzeltmesini, kodu incelemesini veya bir özellik oluşturmasını isteyen prompt'lar vermeye başlayabilirsiniz.

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

Droid'i harici bir API'ye bağlamak, yalnızca yerleşik seçeneklerle sınırlı kalmak yerine tercih ettiğiniz modelle çalışma özgürlüğü verir. Kurulum, Droid CLI içinde ayarlar dosyasına özel bir model eklenerek yapılır ve kaydedildikten sonra model /model menüsünden kullanılabilir hale 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 basit bir örnek olarak Kimi'yi kullanır:

Adım 1: Moonshot AI'dan bir Kimi API anahtarı alın

Moonshot AI'dan Kimi API anahtarınızı oluşturarak veya kopyalayarak başlayın. Bu anahtara ihtiyacınız olacak çünkü Droid, Kimi API'ye bağlanmak ve kendi hesabınız üzerinden istek göndermek için bunu kullanır. Ayarlar dosyası içinde güvenli bir şekilde kullanılabilmesi için anahtarı MOONSHOT_API_KEY gibi bir ortam değişkeni olarak kaydetmeniz en iyisidir.

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

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

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

settings.json içinde, Kimi'yi customModels dizisi altına ekleyin. Bu, Droid'e hangi modeli kullanacağını, hangi API uç noktasını çağırması gerektiğini, hangi sağlayıcı formatını izlediğini ve kimlik doğrulama için hangi API anahtarının kullanılması gerektiğini belirtir. Dosyada zaten başka ayarlar varsa her şeyi değiştirmeyin, sadece 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 } ] } ```

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

Yapılandırmayı ekledikten sonra dosyayı kaydedin ve Droid CLI'yi yeniden başlatın. Bu, Droid'in güncellenmiş ayarları yeniden yüklemesini ve yeni eklenen özel modeli düzgün bir şekilde tanımasını sağlar.

Adım 5: 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 Özel modeller bölümünde görünecektir. Kodlama oturumunuz için Kimi'yi etkin model haline getirmek üzere listeden onu seçin.

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

Kimi seçildikten sonra, Droid'de onu gerçek işler için kullanmaya başlayabilirsiniz. Kod incelemek, bir hatayı düzeltmek veya bir kod tabanını açıklamak gibi bir prompt deneyin. Droid, isteği Kimi API üzerinden gönderecek ve görev için bu modeli kullanacaktır.

Kimi API kullanmanın faydaları

Kimi'yi Droid'e bağladıktan sonra, artık CLI'daki sıradan bir harici model olmaktan çok daha fazlasına dönüşür. Günlük geliştirme iş akışınıza uyum sağlayan, hem küçük kodlama işlerinde hem de daha büyük mühendislik görevlerinde yardımcı olan pratik bir kodlama asistanına dönüşür. İşte Kimi API kullanmanın bazı faydaları:

Geliştirme verimliliğini artırın

Kimi, çalışırken kod üreterek, mantığı açıklayarak ve düzeltmeler önererek günlük kodlama görevlerini daha hızlı tamamlamanıza yardımcı olabilir. Bu, basit geliştirme desteği için birden fazla araç arasında geçiş yapmanız gerekmediği anlamına gelir. Kimi, Droid içinde olduğunda rutin programlama işleri daha kolay yönetilir hale gelir.

Daha güvenilir kod yazın

Kimi, kodunuzu inceleyebilir, olası sorunları belirtebilir ve küçük hatalar daha büyük problemlere dönüşmeden önce yapının iyileştirilmesine yardımcı olabilir. Daha temiz mantık ve daha iyi sürdürülebilirlik istediğinizde bu tür erken geri bildirimler faydalıdır. Zaman içinde, test edilmesi, güncellenmesi ve anlaşılması daha kolay kod yazmanıza yardımcı olabilir.

Çeşitli geliştirme görevlerini yönetin

Kimi, sıfırdan kod yazmakla sınırlı değildir. Ayrıca yeniden düzenleme (refactoring), kod dokümantasyonu, tanıdık olmayan projeleri anlama ve farklı görevler arasında özellik geliştirmeyi destekleme konularında da yardımcı olabilir. Bu, iş akışının birçok parçasında yardımcı olacak tek bir AI modeli isteyen geliştiriciler için onu esnek bir seçenek haline getirir.

API bağlantısında sık görülen hataların çözümü

Droid'de harici bir API anahtarı bağlamak genellikle basittir, ancak küçük kurulum hataları yine de sorunlara neden olabilir. Sorunların çoğu Droid'in kendisinden değil, ayarlar dosyasından, sağlayıcı adından, API anahtarından veya model sunucusu yapılandırmasından kaynaklanır. İyi haber şu ki, nereye bakmanız gerektiğini bildiğinizde bu hataları düzeltmek genellikle kolaydır.

Model seçicide görünmüyor

Eski formatı kullanıyorsanız ~/.factory/settings.json veya config.json dosyasındaki JSON söz dizimini kontrol edin
Ayar değişiklikleri dosya izleme (file watching) 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ındaki yazım hatalarını ve büyük/küçük harf kullanımını kontrol edin

Kimlik doğrulama hataları

API anahtarınızın geçerli olduğunu ve kullanılabilir bakiyesi 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 onaylayın

Yerel model bağlanmıyor

Yerel model sunucunuzun çalıştığından emin olun, örneğin ollama serve
Temel URL'nin doğru olduğunu ve sağlayıcı gerektiriyorsa /v1/ içerdiğini doğrulayın
Modelin daha önce indirildiğini (pull edildiğini) veya yerel olarak kullanılabilir olduğunu kontrol edin

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

Sağlayıcınızın API hız sınırlarını ve kullanım kotalarını kontrol edin
Limitlerin aşılıp aşılmadığını görmek için sağlayıcı panosundan kullanımınızı izleyin

Sonuç

Droid'de özel API'ler kullanmak, AI ile kod oluştururken, test ederken ve geliştirirken size daha fazla kontrol sağlar. Kurulum tamamlandığında, kodlama iş akışınızı ihtiyaçlarınıza uyan model etrafında şekillendirmek daha kolay hale gelir. Yerleşik seçeneklerle kalmayı ister, harici bir modele bağlanmayı ister tercih edin, Droid, AI'yı geliştirme sürecinize dahil etmek için esnek bir yol sunar. Özel bir kurulumla başlamak için basit bir yer arıyorsanız, Kimi'yi Droid'de denemeye değer. Günlük kodlama işlerini daha akıcı ve hızlı hale getirmek için pratik bir seçim olabilir.

Droid'i Kimi API ile Bağlama

SSS

Droid hangi yapay zeka modellerini destekler?

Droid hem yerleşik yapay zeka modellerini hem de CLI üzerinden eklenen özel modelleri destekler. Harici kurulum, Anthropic, OpenAI ve genel sohbet tamamlama API'leri gibi sağlayıcı türleriyle çalışır. Bu, kullanıcılara kendi kurulumlarına bağlı olarak resmi API'ler, bazı açık kaynak sağlayıcılar veya yerel modellerle çalışma esnekliği verir.

Harici bir API'yi yapılandırmak için hangi bilgiler gereklidir?

Droid'de harici bir API'yi 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ı kurulumlar ayrıca maksimum çıktı token'ı, ek argümanlar veya ek başlıklar gibi isteğe bağlı alanlar da içerebilir. Bu bilgiler Droid'in modele doğru şekilde bağlanmasına yardımcı olur.

Yerleşik ve harici yapay zeka modelleri arasında geçiş yapabilir miyim?

Evet, Droid yerleşik ve harici modeller arasında geçiş yapmanıza olanak tanır. Yerleşik modeller uygulama içinden seçilebilirken, özel modeller kurulumdan sonra CLI'deki /model menüsünden seçilebilir. Bu, farklı kodlama görevleri için farklı modeller kullanmayı kolaylaştırır.

Neden bir hız sınırı veya kota hatası görüyorum?

Bu genellikle API sağlayıcınızın kullanım sınırına, istek üst sınırına veya faturalandırma kotasına ulaştığı anlamına gelir. Kredilerinizi, kullanımınızı ve hız sınırlarınızı incelemek için sağlayıcı panelinizi kontrol edin. Sınır sorunu çözüldükten sonra, model başka herhangi bir yapılandırma değişikliği yapmanıza gerek kalmadan Droid'de yeniden çalışmalıdır.