Pengaturan Droid API: Cara Menghubungkan Model AI Kustom

Droid mendukung model AI bawaan maupun model AI eksternal, sehingga Anda punya lebih banyak fleksibilitas untuk tugas coding. Panduan ini membahas cara menghubungkan API eksternal, mengonfigurasi setelan Anda, mengatasi masalah umum, dan menggunakan Kimi untuk mendukung pengembangan berbantuan AI. Catatan: Panduan ini hanya berlaku untuk Droid CLI. Model kustom saat ini hanya didukung di CLI dan belum tersedia di produk Droid lainnya.

Menghubungkan Droid dengan Kimi API

10 menit baca2026-08-12

Ingin menggunakan model AI Anda sendiri untuk coding tanpa pengaturan yang rumit? Droid mempermudah hal ini dengan mendukung API eksternal di CLI-nya, sehingga Anda dapat menghubungkan model kustom yang sesuai dengan alur kerja Anda. Panduan ini menunjukkan cara mengatur API, memperbaiki masalah umum, dan menggunakan Kimi di Droid. Terus baca untuk memulai.

Apa itu Droid?

Droid adalah alat coding AI yang membantu developer menulis kode, mengatasi error, dan menangani tugas pengembangan dengan lebih efisien. Droid mendukung model AI bawaan dan juga memungkinkan pengguna menghubungkan model kustom lewat CLI-nya untuk fleksibilitas yang lebih besar. Ini membuatnya berguna untuk berbagai alur kerja coding, baik Anda memerlukan bantuan cepat maupun pengaturan yang lebih personal.

Cara menggunakan model AI bawaan di Droid?

Model AI bawaan memudahkan Anda untuk mulai coding dengan Droid karena Anda tidak perlu menghubungkan ke API eksternal terlebih dahulu. Setelah aplikasi terpasang, Anda dapat memilih model di dalam platform dan mulai menggunakan bantuan AI untuk analisis kode, pengerjaan fitur, perbaikan bug, dan review. Berikut cara memulai dengan Droid:

Langkah 1: Instal dan buka Droid

Mulailah dengan mengunduh Factory App di perangkat Anda dan menyelesaikan instalasinya. Setelah itu, buka aplikasinya dan masuk ke akun Anda. Ini memberi Anda akses ke Droid dan fitur AI bawaannya di dalam aplikasi.

Langkah 2: Hubungkan Droid ke folder proyek Anda

Atur direktori kerja Anda ke basis kode yang ingin Anda kerjakan. Ini menghubungkan Droid dengan proyek lokal Anda sehingga Droid dapat membaca file, memahami struktur kode, dan mendukung tugas pengembangan Anda dengan konteks yang lebih baik.

Langkah 3: Pilih model bawaan dan mulai memberi prompt

Buka pemilih model dan pilih salah satu model AI bawaan yang tersedia di Droid. Setelah model dipilih, Anda dapat mulai memberikan prompt, misalnya meminta Droid menganalisis basis kode, memperbaiki bug, mereview kode, atau membangun fitur.

Cara menghubungkan Droid dengan API eksternal?

Menghubungkan Droid ke API eksternal memberi Anda kebebasan lebih besar untuk bekerja dengan model pilihan Anda, alih-alih terbatas pada opsi bawaan. Pengaturan ini dilakukan di dalam Droid CLI dengan menambahkan model kustom ke file settings, dan setelah disimpan, model tersebut akan tersedia dari menu /model. Langkah-langkah di bawah ini menggunakan Kimi sebagai contoh sederhana, sehingga Anda dapat melihat cara kerja keseluruhan setelan, mulai dari API key hingga pemilihan model:

Langkah 1: Dapatkan Kimi API key dari Moonshot AI

Mulailah dengan membuat atau menyalinKimi API key Anda dari Moonshot AI. Anda memerlukan key ini karena Droid menggunakannya untuk terhubung dengan Kimi API dan mengirim permintaan melalui akun Anda sendiri. Sebaiknya simpan key tersebut sebagai variabel lingkungan seperti MOONSHOT_API_KEY agar dapat digunakan dengan aman di dalam file settings.

Langkah 2: Buka file settings Droid

Selanjutnya, buka file settings tempat model kustom ditambahkan di Droid CLI. Di macOS, path filenya adalah ~/.factory/settings.json. Di Windows PowerShell, gunakan %USERPROFILE%\.factory\settings.json. Ini adalah file utama tempat Droid membaca konfigurasi model kustom Anda.

Langkah 3: Tambahkan Kimi sebagai model kustom

Di dalam settings.json, tambahkan Kimi di bawah array customModels. Ini memberi tahu Droid model mana yang harus digunakan, endpoint API mana yang harus dipanggil, format provider mana yang diikuti, dan API key mana yang harus digunakan untuk autentikasi. Jika file tersebut sudah memiliki setelan lain, jangan mengganti semuanya, cukup tambahkan objek model ini di dalam array customModels yang sudah ada.

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

Langkah 4: Simpan file dan restart Droid

Setelah menambahkan konfigurasi, simpan file tersebut dan restart Droid CLI. Ini memastikan Droid memuat ulang setelan yang telah diperbarui dan mengenali model kustom yang baru ditambahkan dengan benar.

Langkah 5: Pilih model Kimi menggunakan /model di dalam Droid

Buka Droid CLI dan jalankan perintah /model. Setelan Kimi Anda sekarang akan muncul di bagian Custom models. Pilih dari daftar tersebut untuk menjadikan Kimi sebagai model aktif untuk sesi coding Anda.

Langkah 6: Jalankan tugas

Setelah Kimi dipilih, Anda dapat mulai menggunakannya untuk pekerjaan nyata di Droid. Coba prompt seperti meninjau kode, memperbaiki bug, atau menjelaskan sebuah codebase. Droid akan mengirim permintaan tersebut melalui Kimi API dan menggunakan model itu untuk tugas tersebut.

Manfaat menggunakan Kimi API

Setelah menghubungkan Kimi ke Droid, Kimi bukan lagi sekadar model eksternal di CLI. Kimi berubah menjadi asisten coding praktis yang menyatu dengan workflow pengembangan harian Anda dan membantu, baik untuk pekerjaan coding kecil maupun tugas engineering yang lebih besar. Berikut beberapa manfaat menggunakan Kimi API:

Meningkatkan efisiensi pengembangan

Kimi dapat membantu Anda menyelesaikan tugas coding sehari-hari lebih cepat dengan menghasilkan kode, menjelaskan logika, dan menyarankan perbaikan saat Anda bekerja. Artinya, Anda tidak perlu berpindah-pindah antar tool hanya untuk dukungan pengembangan sederhana. Dengan Kimi di dalam Droid, pekerjaan programming rutin menjadi lebih cepat untuk dikelola.

Menulis kode yang lebih andal

Kimi dapat meninjau kode Anda, menunjukkan kemungkinan masalah, dan membantu memperbaiki struktur sebelum kesalahan kecil berkembang menjadi masalah yang lebih besar. Umpan balik dini seperti ini berguna saat Anda menginginkan logika yang lebih bersih dan maintainability yang lebih baik. Lambat laun, ini dapat membantu Anda membangun kode yang lebih mudah diuji, diperbarui, dan dipahami.

Menangani beragam tugas pengembangan

Kimi tidak terbatas pada menulis kode dari nol. Kimi juga dapat membantu refactoring, mendokumentasikan kode, memahami proyek yang belum familiar, dan mendukung pengembangan fitur di berbagai tugas. Ini membuatnya menjadi pilihan yang fleksibel bagi developer yang ingin satu model AI membantu banyak bagian dari workflow mereka.

Mengatasi error umum saat menghubungkan API

Menghubungkan API key eksternal di Droid biasanya cukup mudah, tetapi kesalahan kecil saat pengaturan tetap bisa menimbulkan masalah. Sebagian besar masalah berasal dari file settings, nama provider, API key, atau konfigurasi model server, bukan dari Droid itu sendiri. Untungnya, error semacam ini biasanya mudah diperbaiki begitu Anda tahu di mana harus memeriksanya.

Model tidak muncul di selector

Periksa sintaks JSON di ~/.factory/settings.json atau config.json jika Anda menggunakan format lama
Perubahan settings terdeteksi secara otomatis melalui file watching
Pastikan semua field yang diperlukan ada dalam konfigurasi custom model

Error "Invalid provider"

Pastikan nilai provider tepat berupa anthropic, openai, atau generic-chat-completion-api
Periksa kesalahan penulisan dan penggunaan huruf kapital yang benar pada field provider

Error autentikasi

Pastikan API key Anda valid dan memiliki kredit yang tersedia
Periksa apakah API key memiliki izin yang benar untuk provider tersebut
Pastikan base URL sesuai dengan API endpoint pada dokumentasi provider

Model lokal tidak dapat terhubung

Pastikan model server lokal Anda sedang berjalan, misalnya ollama serve
Pastikan base URL sudah benar dan menyertakan /v1/ jika diperlukan oleh provider
Periksa apakah model sudah di-pull atau sudah tersedia secara lokal

Error rate limiting atau kuota

Periksa rate limit API dan kuota penggunaan dari provider Anda
Pantau penggunaan Anda melalui dashboard provider untuk melihat apakah batasnya sudah tercapai

Kesimpulan

Menggunakan API kustom di Droid memberi Anda lebih banyak kendali atas cara Anda membangun, menguji, dan menyempurnakan kode dengan AI. Setelah pengaturan selesai, akan lebih mudah untuk membentuk workflow coding Anda sesuai model yang cocok dengan kebutuhan Anda. Baik Anda tetap menggunakan opsi bawaan atau menghubungkan model eksternal, Droid memberi Anda cara yang fleksibel untuk membawa AI ke dalam pengembangan. Jika Anda ingin memulai dengan setup kustom yang sederhana, Kimi layak dicoba di Droid. Ini bisa menjadi pilihan praktis untuk membuat pekerjaan coding sehari-hari menjadi lebih lancar dan cepat.

Menghubungkan Droid dengan Kimi API

FAQ

Model AI apa saja yang didukung Droid?

Droid mendukung model AI bawaan maupun model kustom yang ditambahkan lewat CLI-nya. Pengaturan eksternal ini bekerja dengan jenis provider seperti Anthropic, OpenAI, dan API chat-completion generik. Ini memberi pengguna fleksibilitas untuk bekerja dengan API resmi, sejumlah provider open-source, atau model lokal, sesuai kebutuhan setelan mereka.

Informasi apa yang diperlukan untuk mengonfigurasi API eksternal?

Untuk mengonfigurasi API eksternal di Droid, biasanya Anda memerlukan ID model, nama tampilan, base URL, API key, dan jenis provider. Beberapa setelan juga bisa menyertakan kolom opsional seperti jumlah maksimum token output, argumen tambahan, atau header tambahan. Detail-detail ini membantu Droid terhubung ke model dengan benar.

Bisakah saya beralih antara model AI bawaan dan eksternal?

Ya, Droid memungkinkan Anda beralih antara model bawaan dan model eksternal. Model bawaan dapat dipilih di dalam aplikasi, sedangkan model kustom dapat dipilih dari menu /model di CLI setelah pengaturan selesai. Ini memudahkan Anda menggunakan model yang berbeda untuk tugas coding yang berbeda.

Mengapa saya melihat error rate limit atau kuota?

Ini biasanya berarti provider API Anda telah mencapai batas penggunaan, batas permintaan, atau kuota penagihan. Periksa dasbor provider Anda untuk meninjau kredit, penggunaan, dan rate limit. Setelah masalah batas ini teratasi, model tersebut seharusnya berfungsi kembali di Droid tanpa perlu perubahan konfigurasi lebih lanjut.

Anda Mungkin Juga Menyukai