Factory Droid
Tambahkan model Hostlinku sebagai customModels di ~/.factory/settings.json dan pakai di Droid CLI maupun aplikasi desktop Factory
Droid — agent coding dari Factory — mendukung BYOK
custom models. Model kustom dibaca dari ~/.factory/settings.json dan tersedia di Droid CLI serta
aplikasi desktop Factory (bukan di platform web/mobile Factory). API key tetap lokal, tidak dikirim
ke server Factory.
Simpan API key di environment
export HOSTLINKU_API_KEY=sk-isi-api-key-kamuTambahkan ke ~/.zshrc / ~/.bashrc agar permanen. Droid membaca referensi ${HOSTLINKU_API_KEY}
dari settings.json.
Daftarkan model di settings.json
Buka (atau buat) ~/.factory/settings.json, lalu tambahkan customModels:
{
"customModels": [
{
"model": "claude-sonnet-4-6",
"displayName": "Claude Sonnet 4.6 (Hostlinku)",
"baseUrl": "https://api.hostlinku.com",
"apiKey": "${HOSTLINKU_API_KEY}",
"provider": "anthropic",
"maxOutputTokens": 64000
},
{
"model": "gpt-5-5",
"displayName": "GPT-5.5 (Hostlinku)",
"baseUrl": "https://api.hostlinku.com/v1",
"apiKey": "${HOSTLINKU_API_KEY}",
"provider": "generic-chat-completion-api",
"maxOutputTokens": 64000
},
{
"model": "deepseek-v4-flash",
"displayName": "DeepSeek V4 Flash (Hostlinku)",
"baseUrl": "https://api.hostlinku.com/v1",
"apiKey": "${HOSTLINKU_API_KEY}",
"provider": "generic-chat-completion-api",
"maxOutputTokens": 32000
}
]
}Pilih model di Droid
Jalankan droid, ketik /model, lalu pilih model di bagian Custom models (nama sesuai
displayName). Request pertama tampil di console → Log Permintaan.
Yang perlu diketahui
Provider anthropic memakai Messages API, jadi cache_control diteruskan dan prompt caching
bekerja penuh. Cek penghematannya dengan /cost di Droid atau kolom cache di Log Permintaan.
- Slug GPT dan model lain (DeepSeek, GLM, Qwen, Kimi) paling kompatibel lewat
generic-chat-completion-api. Provideropenaidi Droid memakai Responses API; Hostlinku melayani Responses secara stateless (detail), jadi pilih Chat Completions bila ragu. maxOutputTokensjangan melebihi batas output model di katalog.- Prompt caching untuk provider generic bergantung pada model tujuan.