Factory Droid

Entri customModels di ~/.factory/settings.json — model, baseUrl, dan provider — menempatkan Droid pada endpoint apa pun yang berbicara Anthropic Messages atau OpenAI Chat Completions.

// ~/.factory/settings.json  (Windows: %USERPROFILE%\.factory\settings.json)
{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "Sonnet 5 [Kunavo]",
      "baseUrl": "https://api.kunavo.com",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "anthropic"
    },
    {
      "model": "gpt-5-6-sol",
      "displayName": "GPT-5.6 Sol [Kunavo]",
      "baseUrl": "https://api.kunavo.com/v1",
      "apiKey": "${KUNAVO_API_KEY}",
      "provider": "generic-chat-completion-api"
    }
  ]
}

// Then, in the shell Droid starts from:
//   export KUNAVO_API_KEY=sk-kn-...
// ${VAR_NAME} expansion is a settings.json feature. It does NOT apply to the
// legacy ~/.factory/config.json, which Factory still loads and merges.

Langkah demi langkah

1. Buat key di /app/keys lalu salin — key hanya ditampilkan sekali. Ekspor sebagai KUNAVO_API_KEY di shell tempat Anda menjalankan Droid, agar key itu sendiri tidak pernah tersimpan dalam file pengaturan.
2. Buka ~/.factory/settings.json (buat jika belum ada), lalu tambahkan array customModels di atas. Factory menetapkan tepat tiga kolom wajib — model, baseUrl, dan provider — sedangkan displayName adalah label yang ditampilkan pemilih.
3. Periksa ejaan provider. Nilainya harus persis salah satu dari anthropic, openai, atau generic-chat-completion-api; bagian pemecahan masalah Factory mencantumkan salah ketik di sana sebagai penyebab error "Invalid provider".
4. Jalankan /model di CLI. Entri Anda akan muncul di bagian Model kustom tersendiri, di bawah entri bawaan Factory, dengan label displayName yang Anda tetapkan. Factory memantau file pengaturan, jadi cukup simpan — tidak perlu memulai ulang.
5. Berikan tugas yang membaca dan mengedit file, bukan sekadar sapaan. Droid mengandalkan pemanggilan tool untuk hampir semua hal yang dilakukannya, dan giliran chat biasa tidak akan menguji bagian tersebut. Setelah itu jalankan /cost, tempat Factory melaporkan tingkat cache hit — Kunavo menyediakan penanda cache_control milik Anthropic secara native, dan catatan Factory sendiri menyebutkan bahwa pada provider Chat Completions generik, caching “bervariasi menurut provider dan tidak dapat dijamin”.

Diperiksa terhadap Halaman Custom Models (BYOK) Factory pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Factory Droid.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Hal yang tidak dapat dijangkau model kustom di Droid

Ada tiga batasan yang dijelaskan di halaman Factory sendiri. Masing-masing memengaruhi ekspektasi Anda terhadap konfigurasi di atas, bukan apakah konfigurasi itu berfungsi.

• Hanya tersedia di aplikasi lokal. Halaman BYOK Factory menyatakan bahwa model kustom tersedia di CLI Droid dan aplikasi desktop, yang membaca settings.json lokal Anda, dan bahwa model tersebut “tidak muncul di platform web atau seluler yang dihosting Factory”. Pekerjaan yang didelegasikan melalui produk yang dihosting tetap menggunakan inferensi yang ditagihkan oleh Factory, apa pun key yang Anda konfigurasi di sini.
• Administrator dapat menonaktifkannya. Kontrol enterprise Factory mendokumentasikan modelPolicy.allowCustomModels dan allowedBaseUrls, yang masing-masing menonaktifkan BYOK pengguna sepenuhnya atau membatasi semua model kustom ke satu host yang disetujui. Jika Anda menggunakan mesin terkelola, periksa hal itu sebelum menelusuri masalah pada file.
• Biaya paket tetap berlaku. Key di sini bersifat tambahan, bukan pengganti — biaya yang dikenakan Factory setelah batas BYOK Anda, serta besarnya batas tersebut, dibahas dalam panduan biaya dan tidak dihitung ulang di halaman ini.

Ada satu jebakan yang perlu diketahui sebelum Anda menyalin konfigurasi dari tempat lain: Factory masih memuat ~/.factory/config.json lama dengan custom_models dan base_url snake_case, lalu menggabungkannya di bawah settings.json. Factory juga mendokumentasikan bahwa ekspansi ${VAR_NAME} tidak berlaku di sana. Key yang ditulis sebagai placeholder di file itu akan dikirim secara literal. Gunakan settings.json.