TokenLab

程式工具

Gemini CLI

設定 Google Gemini CLI 以使用 TokenLab API

概覽

Gemini CLI 0.60.0 記錄了用於 API-key 驗證的 GOOGLE_GEMINI_BASE_URL。請使用 TokenLab 的 Gemini 原生端點,並搭配支援 gemini_generate_content 的當前模型。請參閱官方設定參考與驗證指南。此設定不會透過 TokenLab 路由 Google 訂閱。

安裝

Gemini CLI 0.60.0 需要 Node.js 20 或更新版本。

npm install -g @google/gemini-cli@0.60.0
gemini --version

設定

請使用 快速入門 中針對 macOS、Linux、WSL 或 Windows PowerShell 的終端機指令來設定 TOKENLAB_API_KEY,以避免將金鑰寫入指令歷史記錄中。請從該終端機啟動 Gemini CLI。若需長期使用,請使用您本地的密碼管理員;請勿將明文金鑰附加到您的 shell 設定檔中。

請保留您目前的 Google 登入資訊與設定。若要進行獨立的 TokenLab 啟動,請選擇一個未使用的設定根目錄,例如 ~/.gemini-tokenlab(PowerShell 上為 $HOME),並建立其 .gemini 目錄。將您現有的 .gemini/settings.json 以及您的設定所需的任何策略檔案複製到對應位置,並保留權限、沙盒與其他無關的設定。僅在該副本中合併以下驗證欄位;若無設定檔,請建立一個。請勿複製 OAuth 快取或清除您原始的憑證。請遵循託管驗證策略,而非覆寫它。

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

使用方式

下方的啟動指令使用 ~/.gemini-tokenlab/.gemini/settings.json。如果您選擇了其他根目錄,請調整路徑。請透過 Gemini 的標準信任提示核准工作目錄;保留現有的工具核准策略。模型將針對此工作階段明確選定。

GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flash

這些變數僅適用於本次啟動;您已儲存的帳戶、預設模型與權限設定將保持不變。若要使用您先前的設定,請在不帶這些變數的情況下正常啟動。請勿將它們永久儲存在您的 shell 設定檔中。

驗證

儲存設定或列出模型並不會驗證金鑰或已完成的請求。提示詞會消耗 TokenLab 餘額。在嘗試使用工具前,請檢查回覆及其對應的 請求記錄;輔助請求也可能會計費。

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

在同一個 Agent 中生成圖像與影片

Gemini CLI 也可以透過 TokenLab MCP server 建立圖像與短影片。每次生成都會從相同的 TokenLab 餘額中扣除。請將此項目合併到 TokenLab 的設定副本 ~/.gemini-tokenlab/.gemini/settings.json 中。Gemini CLI 會從啟動環境中讀取 $TOKENLAB_API_KEY,因此金鑰不會被寫入檔案中:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
      }
    }
  }
}

使用上述啟動指令啟動 Gemini CLI 並執行 /mcp。tokenlab 伺服器必須顯示為已連線;若未顯示,請信任該工作資料夾。接著嘗試:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video 會回傳一個任務 ID。Agent 會呼叫 get_task_status 直到影片準備就緒。請參閱 Gemini CLI MCP 指南 以了解其他設定。

本頁內容