卡皮巴拉 API 使用教程

Appearance

常见问题 ​

这里汇总卡皮巴拉 API 接入各类工具时最常见的问题。配置失败时，建议先按本页逐项检查。

API 请求失败怎么办？ ​

优先检查下面几项：

  • API Key 是否复制完整。
  • 请求地址是否填写正确。
  • 账户余额是否充足。
  • 模型名称是否是平台当前支持的模型。
  • 工具里选择的供应商或模型是否已经启用。

API Key 应该填在哪里？ ​

API Key 一般填到工具里的“API Key”“密钥”或认证字段对应位置。

常见格式如下：

text
sk-...

WARNING

不要把 API Key 填进请求地址，也不要把真实 Key 发到聊天、截图、文章或代码仓库里。

请求地址应该怎么填？ ​

不同工具要求略有不同：

text
https://kapibala.asia

部分 OpenAI-compatible 工具需要填写：

text
https://kapibala.asia/v1

如果工具会自己拼接后续路径，请按教程要求不要在末尾额外添加 /。

模型列表获取不到怎么办？ ​

可以按下面顺序排查：

  • 确认 API Key 有效且余额充足。
  • 确认请求地址没有写错。
  • 确认工具使用的是 OpenAI-compatible 或对应教程里的接入方式。
  • 如果使用 CC Switch，确认当前供应商已经保存并启用。

/model 里看不到模型怎么办？ ​

在 Claude Code、Codex 或 CC Switch 这类工具中，界面显示的模型名和实际请求模型可能不是同一个字段。

请检查：

  • “显示名称”是否填写。
  • “实际请求模型”是否填写为平台支持的模型名。
  • 是否点击保存，并在工具中切换到了刚配置的供应商。

请求地址末尾能不能带 /？ ​

一般建议不要带，尤其是 Claude Code、CC Switch 等工具中复制主域名时。

推荐：

text
https://kapibala.asia

不推荐：

text
https://kapibala.asia/

部分 OpenAI-compatible 配置需要 /v1，则按对应教程填写：

text
https://kapibala.asia/v1

Image 2 生成图片不可用怎么办？ ​

先确认模型列表中是否能看到：

text
gpt-image-2

如果看不到，优先检查 OPENAI_API_KEY、OPENAI_BASE_URL、Python OpenAI 客户端安装情况，以及账户是否有可用额度。

配置完成后还是不能用怎么办？ ​

建议先重启相关工具，例如 CC Switch、Codex、Claude Code 或 EchoBird。

如果仍然失败，记录下面信息后再排查：

  • 使用的工具名称和版本。
  • 填写的请求地址。
  • 选择的模型名。
  • 报错截图或错误文本。
  • 当前账户余额是否充足。