TokiLabsDocs
參考

常見問題

遇到問題請先看這裡。仍未解決，請寄信到 team@support.tokilabs.xyz，並附上錯誤訊息和請求時間。

錯誤

回傳 401 / 無效的令牌
  • 檢查金鑰是否完整複製（以 sk- 開頭，前後沒有空格）。
  • 令牌可能已過期、被停用或額度用完，請到 控制台 → 令牌 查看狀態。
  • 帳戶餘額不足也會導致請求失敗，請到「錢包」查看。
提示模型不存在或無可用管道

請確認模型名稱拼寫與 模型列表 完全一致。

回傳 404 Not Found

通常是 /v1 位置不對：

  • Claude Code、Anthropic SDK：https://api.tokilabs.xyz（不帶 /v1）
  • OpenAI SDK、Codex、Cursor 等：https://api.tokilabs.xyz/v1（帶 /v1）
回傳 429 請求過多

短時間內請求過於頻繁。請稍候再試；批次任務請降低並行數。

設定

設定了環境變數但不生效
  • Windows：環境變數只對之後新開啟的程式生效，請關閉所有終端機和 VS Code 後重新開啟，必要時登出再重新登入。
  • macOS / Linux：執行 source ~/.zshrc（或 ~/.bashrc），或者開啟一個新的終端機視窗。
  • 用 echo $ANTHROPIC_BASE_URL（PowerShell：$env:ANTHROPIC_BASE_URL）確認變數確實存在。
Claude Code 啟動後要求登入官方帳號

在 ~/.claude.json 中加入 "hasCompletedOnboarding": true，並確認 ANTHROPIC_AUTH_TOKEN 已設定。如果之前登入過官方帳號，請先在 Claude Code 中執行 /logout。詳見 Claude Code。

PowerShell 提示「已停用指令碼執行」

執行一次：

PowerShell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
PowerShell 中的 curl 指令出錯

Windows PowerShell 5.1 中的 curl 是 Invoke-WebRequest 的別名，參數完全不同。請使用 curl.exe。

npm install -g 提示權限不足（EACCES）

在 macOS / Linux 上使用系統內建的 Node 時會出現。建議改用 nvm 安裝 Node（見 Linux 指南），不要使用 sudo npm。

網路

請求逾時或連線失敗
  • 先在瀏覽器中開啟 api.tokilabs.xyz，確認能正常存取。
  • 如果開啟了 Proxy，請檢查 HTTPS_PROXY / HTTP_PROXY 環境變數是否指向一個已失效的位址。可以把 api.tokilabs.xyz 加入 NO_PROXY 直接連線。
  • 公司網路可能攔截了 HTTPS 請求，可嘗試切換網路。
長時間生成時連線被中斷

建議開啟串流輸出（stream: true），並把用戶端逾時時間設定在 10 分鐘以上。

計費

如何計費？

依實際使用的 Token 計費，輸入、輸出、快取讀寫分別計價。具體價格請見 價格頁面，每次呼叫的明細可在 使用紀錄 中查詢。

金鑰外洩了怎麼辦？

立即在 控制台 → 令牌 中刪除該令牌，然後建立新的令牌並更新到你的工具中。