Factory Droid

~/.factory/settings.jsonのcustomModelsエントリ — model、baseUrl、provider — で、DroidをAnthropic Messagesまたは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.

手順

1. /app/keysでキーを作成してコピーします。キーが表示されるのは一度だけです。Droidを起動するシェルで環境変数KUNAVO_API_KEYとして設定してください。これにより、キーそのものが設定ファイルに保存されることはありません。
2. ~/.factory/settings.jsonを開き（存在しない場合は作成し）、上記のcustomModels配列を追加します。Factoryが必須としているフィールドはmodel、baseUrl、providerの3つで、displayNameはモデル選択画面に表示されるラベルです。
3. providerの表記を確認してください。anthropic、openai、generic-chat-completion-apiのいずれかと完全に一致する必要があります。Factoryのトラブルシューティングでは、表記ミスが"Invalid provider"エラーの原因として挙げられています。
4. CLIで/modelを実行します。項目はFactory独自のセクションの下にある別個のカスタムモデルセクションに、設定したdisplayNameのラベルで表示されます。Factoryは設定ファイルを監視しているため、保存するだけで反映され、再起動は不要です。
5. 挨拶ではなく、ファイルを読み書きするタスクを与えてください。Droidはほぼすべての処理でツール呼び出しを利用するため、通常のチャットだけではその部分を確認できません。次に/costを実行します。ここでFactoryがキャッシュヒット率を報告します。KunavoはAnthropicのcache_controlマーカーをネイティブに提供します。一方、Factoryは汎用Chat Completionsプロバイダーについて、キャッシュの動作は「プロバイダーによって異なり、保証できない」と説明しています。

FactoryのCustom Models（BYOK）ページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーが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

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

Droidのカスタムモデルで利用できない機能

Factoryの公式ページに記載された3つの制限は、いずれも上記の設定が機能するかどうかではなく、何を期待できるかに関わります。

• ローカル環境でのみ利用できます。 FactoryのBYOKページには、カスタムモデルはローカルのsettings.jsonを読み込むDroid CLIとデスクトップアプリで利用できる一方、「Factoryのホスト型Webプラットフォームやモバイルプラットフォームには表示されない」と記載されています。ホスト型製品を通じて委任した処理では、ここで設定したキーにかかわらず、引き続きFactory請求の推論が使われます。
• 管理者が無効にできます。 Factoryのエンタープライズ向け制御には、ユーザーのBYOKを全面的に無効にするmodelPolicy.allowCustomModelsと、すべてのカスタムモデルの接続先を承認済みホスト1つに固定するallowedBaseUrlsが記載されています。管理対象のマシンでは、設定ファイルの問題を調べる前に確認してください。
• プラン料金は引き続き発生します。 ここで使うキーは置き換えではなく追加です。BYOKの利用枠を超えた場合のFactoryの請求と、利用枠の内容については料金ガイドで説明されており、このページでは再計算していません。

他の場所から設定をコピーする前に知っておきたい注意点が1つあります。Factoryは、snake_case形式のcustom_modelsとbase_urlを使う旧式の~/.factory/config.jsonも引き続き読み込み、それをsettings.jsonの下にマージします。また、そこでは${VAR_NAME}の展開が適用されないことがドキュメントに記載されています。そのファイルにプレースホルダーとして書かれたキーは、そのままの文字列で送信されます。settings.jsonを使ってください。