Pengaturan API Droid: Cara Menghubungkan Model AI Kustom

Droid mendukung model AI bawaan dan eksternal, sehingga Anda lebih leluasa untuk mengerjakan tugas coding. Panduan ini menjelaskan cara menghubungkan API eksternal, mengonfigurasi pengaturan, mengatasi masalah umum, dan menggunakan Kimi untuk mendukung pengembangan berbantuan AI. Catatan: Model kustom didukung di Droid CLI dan aplikasi desktop Factory (melalui settings.json lokal), tetapi tidak di platform web atau seluler Factory yang dihosting.

10 menit bacaDiperbarui: 2026-09-28
Cara Menghubungkan Kimi API ke Droid

Ingin menggunakan model AI sendiri untuk coding tanpa pengaturan yang rumit? Droid memudahkannya dengan mendukung API eksternal di CLI-nya, sehingga Anda dapat menghubungkan model kustom yang sesuai dengan alur kerja Anda. Panduan ini menunjukkan cara menyiapkan API, mengatasi masalah umum, dan menggunakan Kimi di Droid. Lanjutkan membaca untuk memulai.

Apa itu Droid?

Droid adalah alat coding AI yang membantu pengembang menulis kode, mengatasi error, dan menangani tugas pengembangan dengan lebih efisien. Droid mendukung model AI bawaan dan juga memungkinkan pengguna menghubungkan model kustom melalui CLI-nya agar lebih fleksibel. Ini berguna untuk berbagai alur kerja coding, baik saat Anda membutuhkan bantuan cepat maupun pengaturan yang lebih personal.

Cara menggunakan model AI bawaan di Droid?

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

Langkah 1: Instal dan buka Droid

Mulailah dengan mengunduh Factory App ke perangkat Anda dan menyelesaikan instalasinya. Setelah itu, buka aplikasi dan masuk ke akun Anda. Dengan begitu, Anda dapat mengakses Droid serta fitur AI bawaannya di dalam aplikasi.

Instal dan buka Droid

Langkah 2: Hubungkan Droid ke folder proyek Anda

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

Hubungkan Droid ke folder proyek Anda

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 memintanya menganalisis codebase, memperbaiki bug, meninjau kode, atau membuat fitur.

Pilih model bawaan dan mulai memberi prompt

Cara menghubungkan Droid ke API eksternal?

Menghubungkan Droid ke API eksternal memberi Anda lebih banyak kebebasan untuk menggunakan model yang diinginkan, alih-alih terbatas pada opsi bawaan. Pengaturan dilakukan di Droid CLI dengan menambahkan model kustom ke file pengaturan. Setelah disimpan, model tersedia dari menu /model. Langkah-langkah berikut menggunakan Kimi sebagai contoh sederhana agar Anda dapat melihat cara kerja pengaturan lengkap, dari kunci API hingga pemilihan model:

Langkah 1: Dapatkan kunci Kimi API dari Moonshot AI

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

Dapatkan kunci Kimi API dari Moonshot AI

Langkah 2: Buka file pengaturan Droid

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

Langkah 3: Tambahkan Kimi sebagai model kustom

Di dalam settings.json, tambahkan Kimi pada array customModels. Ini memberi tahu Droid model yang akan digunakan, endpoint API yang harus dipanggil, format penyedia yang diikuti, serta kunci API yang digunakan untuk autentikasi. Jika file tersebut sudah memiliki pengaturan lain, jangan mengganti semuanya; cukup tambahkan objek model ini ke dalam array customModels yang 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 mulai ulang Droid

Setelah menambahkan konfigurasi, simpan file lalu mulai ulang Droid CLI. Ini memastikan Droid memuat ulang pengaturan yang 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. Pengaturan Kimi Anda kini akan muncul di bagian model kustom. Pilih dari daftar 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 basis kode. Droid akan mengirim permintaan melalui Kimi API dan menggunakan model tersebut untuk mengerjakan tugas.

Manfaat menggunakan Kimi API

Setelah menghubungkan Kimi ke Droid, Kimi menjadi lebih dari sekadar model eksternal di CLI. Kimi menjadi asisten coding praktis yang menyatu dengan alur kerja pengembangan sehari-hari dan membantu pekerjaan coding kecil maupun tugas engineering yang lebih besar. Berikut beberapa manfaat menggunakan Kimi API:

  • Tingkatkan 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 antaralat untuk dukungan pengembangan sederhana. Dengan Kimi di dalam Droid, pekerjaan pemrograman rutin dapat dikelola lebih cepat.

  • Tulis kode yang lebih andal

Kimi dapat meninjau kode Anda, menunjukkan potensi masalah, dan membantu memperbaiki strukturnya sebelum kesalahan kecil menjadi masalah yang lebih besar. Umpan balik awal seperti ini berguna saat Anda menginginkan logika yang lebih bersih dan kemudahan pemeliharaan yang lebih baik. Seiring waktu, Kimi dapat membantu Anda membangun kode yang lebih mudah diuji, diperbarui, dan dipahami.

  • Tangani beragam tugas pengembangan

Kimi tidak terbatas pada penulisan kode dari awal. Kimi juga dapat membantu refactoring, mendokumentasikan kode, memahami proyek yang belum familier, serta mendukung pengembangan fitur untuk berbagai tugas. Ini menjadikannya pilihan fleksibel bagi developer yang ingin satu model AI membantu banyak bagian dalam alur kerja.

Pemecahan masalah umum saat menghubungkan API

Menghubungkan kunci API eksternal di Droid biasanya mudah, tetapi kesalahan kecil saat pengaturan tetap dapat menimbulkan masalah. Sebagian besar masalah berasal dari file pengaturan, nama provider, kunci API, atau konfigurasi server model, bukan dari Droid itu sendiri. Kabar baiknya, kesalahan ini sering kali mudah diperbaiki setelah Anda mengetahui bagian yang perlu diperiksa.

Model tidak muncul di pemilih

  • Periksa sintaks JSON di ~/.factory/settings.json atau config.json jika Anda menggunakan format lama

  • Perubahan pengaturan terdeteksi secara otomatis melalui pemantauan file

  • Pastikan semua kolom yang diperlukan ada dalam konfigurasi model kustom

Error "provider tidak valid"

  • Pastikan nilai provider tepat berupa anthropic, openai, atau generic-chat-completion-api

  • Periksa kesalahan ejaan dan penggunaan huruf besar yang benar pada kolom provider

Error autentikasi

  • Pastikan kunci API Anda valid dan memiliki kredit yang tersedia

  • Periksa bahwa kunci API memiliki izin yang tepat untuk provider

  • Pastikan URL dasar sesuai dengan endpoint API dalam dokumentasi provider

Model lokal tidak dapat terhubung

  • Pastikan server model lokal Anda berjalan, seperti ollama serve

  • Pastikan URL dasar sudah benar dan menyertakan /v1/ jika diwajibkan oleh provider

  • Periksa bahwa model sudah diunduh atau tersedia secara lokal

Error batas laju atau kuota

  • Periksa batas laju API dan kuota penggunaan provider Anda

  • Pantau penggunaan Anda di dashboard provider untuk mengetahui apakah batas telah tercapai

Kesimpulan

Menggunakan API kustom di Droid memberi Anda kontrol lebih besar atas cara membangun, menguji, dan meningkatkan kode dengan AI. Setelah pengaturan selesai, Anda akan lebih mudah menyesuaikan alur kerja coding dengan model yang sesuai kebutuhan. Baik tetap menggunakan opsi bawaan maupun menghubungkan model eksternal, Droid menawarkan cara fleksibel untuk menghadirkan AI ke dalam pengembangan. Jika Anda ingin memulai pengaturan kustom dengan mudah, Kimi layak dicoba di Droid. Kimi dapat menjadi pilihan praktis untuk membuat pekerjaan coding sehari-hari lebih lancar dan cepat.

FAQ

Droid mendukung model AI bawaan serta model kustom yang ditambahkan melalui CLI-nya. Pengaturan eksternal dapat digunakan dengan jenis penyedia seperti Anthropic, OpenAI, dan API penyelesaian chat generik. Dengan demikian, pengguna dapat bekerja dengan API resmi, beberapa penyedia open-source, atau model lokal sesuai pengaturan mereka.
Untuk mengonfigurasi API eksternal di Droid, biasanya Anda memerlukan ID model, nama tampilan, URL dasar, kunci API, dan jenis penyedia. Beberapa pengaturan juga dapat mencakup kolom opsional seperti token output maksimum, argumen tambahan, atau header tambahan. Detail ini membantu Droid terhubung ke model dengan benar.
Ya, Droid memungkinkan Anda beralih antara model bawaan dan eksternal. Model bawaan dapat dipilih di aplikasi, sedangkan model kustom dapat dipilih dari menu /model di CLI setelah dikonfigurasi. Ini memudahkan penggunaan model yang berbeda untuk tugas coding yang berbeda.
Biasanya, ini berarti penyedia API Anda telah mencapai batas penggunaan, batas permintaan, atau kuota penagihan. Periksa dasbor penyedia untuk meninjau kredit, penggunaan, dan batas laju. Setelah masalah batas tersebut terselesaikan, model akan kembali berfungsi di Droid tanpa perlu perubahan konfigurasi lebih lanjut.
Anda Mungkin Juga Menyukai
10 AI Agent Builder Populer untuk Membangun Alur Kerja AI
10 AI Agent Builder Populer untuk Membangun Alur Kerja AI
2026-09-28
Panduan Integrasi Trae API untuk Pengembangan AI
Panduan Integrasi Trae API untuk Pengembangan AI
2026-09-28
Panduan n8n AI Agent: Membangun dan Mengotomatiskan Alur Kerja
Panduan n8n AI Agent: Membangun dan Mengotomatiskan Alur Kerja
2026-09-28
Instal Claude Code: Panduan Lengkap untuk Windows & Mac
Instal Claude Code: Panduan Lengkap untuk Windows & Mac
2026-09-28
Cara Menghubungkan API Eksternal ke Kilo Code
Cara Menghubungkan API Eksternal ke Kilo Code
2026-09-28