SilkAPI 使用文档

Appearance

故障排查 ​

如果工具接入 SilkAPI 后无法正常使用，可以按本页顺序检查。

API Key 无效 ​

常见表现：

  • 401 Unauthorized
  • invalid api key
  • authentication failed

检查项：

  1. API Key 是否复制完整。
  2. API Key 前后是否有空格。
  3. API Key 是否已在控制台删除或禁用。
  4. 当前工具是否读取了错误的环境变量。

建议重新创建一个测试 API Key，再复制到工具中验证。

Base URL 填错 ​

常见表现：

  • 404 Not Found
  • connection refused
  • 工具仍然请求官方接口

检查项：

  1. Base URL 是否以 SilkAPI 控制台显示为准。
  2. OpenAI-compatible 工具是否填写了 /v1。
  3. Claude Code 类工具是否需要不带 /v1 的地址。
  4. 修改后是否重启了工具或终端。

示例：

text
OpenAI Compatible: https://api.silkapi.com/v1
Claude Code: https://api.silkapi.com

具体以工具要求和 SilkAPI 控制台显示为准。

模型不存在 ​

常见表现：

  • model not found
  • invalid model
  • model is not available

检查项：

  1. 模型名称是否拼写正确。
  2. 当前订阅或分组是否支持该模型。
  3. 工具是否自动使用了默认模型。
  4. 自定义模型是否需要加前缀，例如 Aider 中的 openai/模型名称。

环境变量不生效 ​

先查看当前终端是否读取到变量：

bash
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

如果没有输出，说明当前终端没有读取配置。修改 ~/.zshrc、~/.bashrc 或系统环境变量后，需要重新打开终端。

查看当前 Shell：

bash
echo $SHELL

如果输出包含 zsh，优先检查 ~/.zshrc。如果输出包含 bash，优先检查 ~/.bashrc 或 ~/.bash_profile。

请求过多或额度不足 ​

常见表现：

  • 429 Too Many Requests
  • rate limit exceeded
  • quota exceeded

检查项：

  1. 当前订阅额度是否充足。
  2. 是否有多个工具共用同一个 API Key。
  3. 是否有 Agent 长时间循环调用。
  4. 是否触发了速率限制。

建议为 Agent 工具使用单独 API Key，便于限制和排查。

工具调用失败 ​

部分 Agent 工具会使用 function calling、tool use 或流式响应。如果模型或接口不完全支持，可能出现工具调用失败。

建议：

  1. 换用 SilkAPI 推荐的工具调用兼容模型。
  2. 先用普通聊天任务验证模型可用。
  3. 再测试读文件、写文件、执行命令等高级能力。
  4. 降低任务复杂度，避免一次性授权高风险操作。

仍然无法解决 ​

请准备以下信息再联系支持：

  • 使用的工具名称和版本
  • Base URL 是否包含 /v1
  • 模型名称
  • 报错截图或完整错误文本
  • 问题发生时间

不要发送完整 API Key。必要时请先打码。