卡拉 Khala AI API 网关接入教程
一个Key畅用多模型，面向国内开发者的AI API网关
1. 快速开始（3分钟上手）
安装（无需安装）
直接使用curl或任意HTTP客户端即可
配置
1. 注册/登录：访问 http://186.244.214.88/register 完成注册
2. 创建API Key：登录后进入「密钥管理」页，点击「创建新密钥」，复制保存生成的Key（仅显示一次）
3. 端点选择：
验证
复制以下命令，替换你的API Key后执行：
curl http://186.244.214.88/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的API_Key" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
}'返回正常响应即配置成功，推荐优先使用deepseek-v4-flash（速度最快）。
2. Claude Code 接入（Anthropic格式）
安装
下载安装官方Claude Code客户端即可
配置
打开终端配置环境变量（Windows用PowerShell，macOS/Linux用bash/zsh）：
# macOS/Linux 临时生效（当前终端窗口）
export ANTHROPIC_BASE_URL=http://186.244.214.88
export ANTHROPIC_AUTH_TOKEN=你的API_Key
# 永久生效（写入配置文件，bash执行）
echo 'export ANTHROPIC_BASE_URL=http://186.244.214.88' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=你的API_Key' >> ~/.bashrc
source ~/.bashrc
# Windows PowerShell 临时生效
$env:ANTHROPIC_BASE_URL = "http://186.244.214.88"
$env:ANTHROPIC_AUTH_TOKEN = "你的API_Key"验证
启动Claude Code，输入任意问题，选择deepseek-v4-pro模型发送，正常返回即配置成功。
3. Codex 接入（OpenAI兼容）
安装
下载安装OpenAI Codex官方客户端/CLI工具
配置
打开Codex设置页，找到「API配置」项，填入以下内容：
CLI临时配置可执行：
export OPENAI_BASE_URL=http://186.244.214.88/v1
export OPENAI_API_KEY=你的API_Key验证
在Codex中输入代码生成请求，正常返回结果即配置成功。
4. Cherry Studio 接入
安装
从Cherry Studio官网下载安装最新版客户端
配置
1. 打开「设置」→「模型服务商」→「添加服务商」，二选一即可：
2. 点击「添加模型」，手动填入以下可用模型ID（可按需添加）：
deepseek-v4-flash、deepseek-v4-pro、deepseek-chat、deepseek-reasoner、deepseek-v4
验证
回到对话页，选择刚添加的模型发送消息，正常返回即成功。
5. Chatbox 接入
安装
从Chatbox官网下载安装对应系统版本客户端
配置
1. 打开「设置」→「模型提供商」，选择「OpenAI」或「Anthropic」
2. 填写配置：
验证
保存设置后回到对话页，发送测试消息，正常响应即配置完成。
6. CC Switch 接入（多客户端统一管理）
安装
安装最新版CC Switch客户端
配置
1. 打开CC Switch「服务商管理」→「添加服务商」
2. 填写通用配置：
3. 在「模型列表」中批量导入可用模型ID：deepseek-v4-flash,deepseek-v4-pro,deepseek-chat,deepseek-reasoner,deepseek-v4
4. 开启「全局代理」，即可让本地所有支持OpenAI/Anthropic格式的客户端自动走卡拉网关，无需单独配置
验证
打开任意已安装的AI客户端（如Claude Code、Chatbox），无需修改原有配置，直接发送消息，CC Switch面板显示请求转发记录即成功。
7. API Key 管理
配置
1. **创建独立令牌**：进入「密钥管理」→「创建新密钥」，可自定义密钥备注（如「开发环境」「Cherry Studio专用」），每个场景建议使用独立Key，便于权限隔离和问题排查
2. **余额查询**：控制台首页实时显示当前账户剩余额度、今日消耗、请求量统计
验证
创建密钥后可在密钥列表看到对应Key的状态、创建时间、最后调用时间，可随时禁用/删除不再使用的Key。
8. 常见问题 FAQ
余额怎么扣？
按实际调用模型的token量计费，不同模型单价不同，控制台「消费记录」页可查看每笔请求的消耗明细，无最低消费、无月费。
模型用不了怎么办？
1. 先检查模型ID是否完全正确（不要打错字，建议直接复制文档内的模型ID）；
2. 确认端点格式匹配：OpenAI兼容端点必须加/v1，Anthropic端点不要加/v1；
3. 查看控制台余额是否充足。