Droid のインストールと API 設定

Droid を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

主要な設定

項目	値
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	モデル広場にある現在の Model ID

前提条件

• 現在のバージョンのツールがインストールされている
• BetterToken API Key：登録して取得
• モデル広場の Model ID

登録して BetterToken API Key を取得→

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

追加要件

インストール

Droid をインストールする

macOS / Linux

curl -fsSL https://app.factory.ai/cli | sh

Windows

irm https://app.factory.ai/cli/windows | iex

手動設定

CLI では /settings → Custom models または /model → Manage custom models からモデルを追加できます。デスクトップアプリでは Settings → Custom Models を開きます。どちらも ~/.factory/settings.json に保存します。以下のファイル編集による設定も利用できます。Factory のカスタムモデルガイドを参照してください。

項目	値
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	モデル広場にある現在の Model ID

設定手順

BetterToken API Key を設定する

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

YOUR_API_KEY を BetterToken API Key に置き換えます。Droid は JSON 設定で ${BETTERTOKEN_API_KEY} の環境変数展開をサポートしています。

Droid の設定ファイルを編集する

設定ファイルのパス：~/.factory/settings.json

{
  "customModels": [
    {
      "displayName": "BetterToken Codex",
      "model": "YOUR_MODEL_ID",
      "baseUrl": "https://bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai"
    }
  ]
}

YOUR_MODEL_ID を、モデル広場からコピーした現在のモデル IDに置き換えます。

Droid を起動してモデルを選択する

cd /path/to/your/project
droid

Droid で /model を入力し、BetterToken Codex を選択します。Factory は設定ファイルの変更を監視します。モデル一覧が更新されない場合は、Droid を終了して再起動してください。

小さなテストタスクを実行する

「このプロジェクトのディレクトリ構造を説明してください」のような小さなタスクから始めます。Droid が結果を返したら、複数ファイルの編集や、より長いエージェントタスクに進みます。

provider を openai に設定します。Factory の BYOK 設定では、この値で OpenAI Responses API を選択します。https://bettertoken.ai/v1 と BetterToken API Key を使用してください。Chat Completions を使う場合は、provider を generic-chat-completion-api に設定します。Base URL は同じです。

Droid 0.248.0 のテストでは、Factory にログインしていない新規プロファイルで、droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" がどちらの値でも成功しました。openai は /v1/responses に、generic-chat-completion-api は /v1/chat/completions にリクエストを送信しました。非対話形式で確認するには droid exec を使ってください。

接続を確認する

短いテストプロンプトを送信します。認証または Model ID のエラーなしでツールがレスポンスを返せば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。

モデルを切り替える

モデルセレクターを開くか、設定の Model フィールドを変更します。モデル広場にある正確な Model ID を使用してから、現在のセッションを再起動してください。

よくあるエラー

トラブルシューティング

症状	確認事項
/model にカスタムモデルがない	JSON を検証し、model、baseUrl、apiKey、provider がすべて存在することを確認します。
Invalid provider	UI の表示名ではなく、正確な小文字の値 "openai" または "generic-chat-completion-api" を使います。
401 または 403	API Key を再度コピーし、Droid プロセスが BETTERTOKEN_API_KEY を読めることと、アカウント残高を確認します。
404 または Model not found	https://bettertoken.ai/v1 を使用し、モデル広場から現在の GPT モデル ID をコピーします。
編集後も古いモデルが残る	/model をもう一度開きます。更新されない場合は、Droid を完全に終了して再起動します。

FAQ

モデルを設定する

モデル広場から正確な Model ID をコピーしてください。

provider を openai に設定すると、Base URL https://bettertoken.ai/v1 で OpenAI Responses API を使用できます。Chat Completions を使う場合は generic-chat-completion-api に設定します。

カスタムヘッダーは必要ですか？

標準的な BetterToken 設定では追加ヘッダーは不要です。別のゲートウェイで明示的に要求される場合にのみ、テナント、ルーティング、監査用のヘッダーを追加してください。

価格と利用状況はどこで確認できますか？

現在のモデル価格には、最新のモデル広場を使用してください。リクエスト使用量と残高は BetterToken Dashboard で確認できます。

関連 FAQ

• OpenAI 互換 API と Anthropic 互換 API

• MCP と API Key / Base URL の違い

• model_provider、base_url、wire_api とは何ですか？

• Cline で OpenAI 互換 API を設定する方法

• 対応ツールを比較する

• API エラー、ステータスコード、レート制限

Advanced setup

関連ガイド

• Factory BYOK の概要

技術詳細

プロトコル、Endpoint、内部プロバイダーフィールド

この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、/chat/completions や /responses を追加しないでください。