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-key查找规则

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_tokens 而不是 max_completion_tokens 時才設定 max_tokens_parameter: true。

驗證內部Zed

在 Agent 或 Inline Assistant 中選擇 TokenHub / YOUR_TOKENHUB_MODEL_ID 並要求其解釋目前文件。如果型號不存在，請檢查 JSON、提供者 ID 和 available_models。對於 401，檢查 Zed 進程可見的 TOKENHUB_API_KEY。如果工具或圖像失敗，請返回capabilities並確保聲明不會超出模型的真實支援。

官方參考

• Zed：使用API存取