Zed エディターのカスタム API セットアップ

Zed は、エージェント設定 UI と OpenAI-compatible エンドポイントの settings.json の両方をサポートします。 Zed が TokenHub API キーをシステム キーチェーンに保存するか、プロバイダー名から派生した環境変数を通じて提供します。キーを settings.json に配置しないでください。

エージェント設定でプロバイダーを追加する

1. コマンド パレットを開き、agent: open settings を実行します。
2. Settings → AI → LLM Providers に移動します。
3. [Add Provider] をクリックし、OpenAI-compatible プロバイダーを選択します。
4. プロバイダー名として「tokenhub」と入力します。
5. https://us-api.tokenhub.com/v1 を API URL として入力します。
6. TokenHub モデル カタログに示されている正確なモデル ID を入力します。
7. そのモデルの実際のコンテキスト ウィンドウに入ります。
8. プロバイダー設定に TokenHub API キーを入力して、Zed がそれをシステム キーチェーンに保存します。

複数のモデルが必要な場合は settings.json を編集します

Zed は、language_models.openai_compatible のプロバイダーをサポートします。このスキーマでは、max_tokens は最大出力ではなく、コンテキスト ウィンドウを意味します。両方の制限を、モデルについて文書化されている値に置き換えます。

{
  "language_models": {
    "openai_compatible": {
      "tokenhub": {
        "api_url": "__API_BASE_URL__/v1",
        "available_models": [
          {
            "name": "YOUR_TOKENHUB_MODEL_ID",
            "display_name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
            "max_tokens": 128000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": false
            }
          }
        ]
      }
    }
  }
}

capabilities が省略された場合、Zed は上記の OpenAI-compatible のデフォルトを使用します。モデルと TokenHub エンドポイントの両方が実際にサポートしている場合にのみ、images、parallel_tool_calls、または別の機能を true に設定します。

Zed の API キー検索ルールに従います。

Zed は、プロバイダー ID を大文字のスネークケースに変換し、_API_KEY を追加します。したがって、プロバイダー ID tokenhub は次のようにマッピングされます。

export TOKENHUB_API_KEY="sk-..."

空ではない環境変数はキーチェーンよりも優先されます。 UI でキーを更新しても、Zed が古い資格情報を送信する場合は、この変数の設定を解除して、Zed を再起動します。

モデル名から推論または応答のサポートを推測しないでください

• TokenHub モデルが OpenAI スタイルの reasoning_effort をサポートする場合、エンドポイントが受け入れる値のみを設定します。 Zed は、none、minimal、low、medium、high、xhigh、および max を公開しますが、サードパーティのエンドポイントはこれよりも少ない値をサポートする可能性があります。
• 現在、TokenHub はこの接続に対してチャット完了を推奨しているため、capabilities.chat_completions: true を維持してください。
• APIのレスポンスが必要な機種のみfalseに変更してください。推論を可能にするためだけに API を切り替えないでください。
• エンドポイントが max_completion_tokens ではなく max_tokens を必要とする場合にのみ、max_tokens_parameter: true を設定します。

Zed 内を確認してください

エージェントまたはインライン アシスタントで TokenHub / YOUR_TOKENHUB_MODEL_ID を選択し、現在のファイルについて説明するように依頼します。モデルが存在しない場合は、JSON、プロバイダー ID、および available_models を確認してください。 401 の場合は、Zed プロセスに表示される TOKENHUB_API_KEY を確認してください。ツールまたはイメージが失敗した場合は、capabilities に戻り、宣言がモデルの実際のサポートを超えていないことを確認してください。

公式リファレンス

• Zed: API アクセスを使用