Factory Droid - Hostlinku Docs

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.

Yang perlu diketahui

Slug GPT dan model lain (DeepSeek, GLM, Qwen, Kimi) paling kompatibel lewat generic-chat-completion-api. Provider openai di Droid memakai Responses API; Hostlinku melayani Responses secara stateless (detail), jadi pilih Chat Completions bila ragu.
maxOutputTokens jangan melebihi batas output model di katalog.
Prompt caching untuk provider generic bergantung pada model tujuan.

Troubleshooting

Gejala	Solusi
Model tidak muncul di `/model`	JSON tidak valid atau `provider` salah ketik — periksa dengan `jq . ~/.factory/settings.json`.
Error variabel tidak ditemukan	`HOSTLINKU_API_KEY` belum di-export di shell yang menjalankan `droid`.
`404` di semua request	Base URL tertukar: `anthropic` tanpa `/v1`, `generic-chat-completion-api` dengan `/v1`.
`404 model_not_found`	`model` harus slug persis dari `GET /v1/models`.