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，确认能正常访问。
  • 如果开启了代理，检查 HTTPS_PROXY / HTTP_PROXY 环境变量是否指向一个已失效的地址。可以把 api.tokilabs.xyz 加入 NO_PROXY 直连。
  • 公司网络可能拦截了 HTTPS 请求，可尝试切换网络。
长时间生成时连接被断开

建议开启流式输出（stream: true），并把客户端超时时间设置到 10 分钟以上。

计费

如何计费？

按实际使用的 Token 计费，输入、输出、缓存读写分别计价。具体价格见 价格页面，每次调用的明细可在 使用日志 中查询。

密钥泄露了怎么办？

立即在 控制台 → 令牌 中删除该令牌，然后创建新的令牌并更新到你的工具中。