程式工具
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 指南 以了解其他設定。