发送第一条消息

这一步的目标是：先不用安装客户端，直接用 OpenAI-compatible 接口发出第一条测试消息。

这样做的好处是排查简单。如果这一步能正常返回，说明你的账号、API Key、请求地址、分组和模型大概率都已经配置正确。后面再接入 Cherry Studio、Codex、Claude Code 等工具时，如果客户端不通，就可以优先检查客户端自己的配置。

第 1 步：准备 4 个值

发送测试请求前，先准备好下面 4 个信息：

项目	示例	从哪里获取
API Key	sk-...	在 API Key 页面复制
请求地址	https://kapibala.asia/v1	OpenAI-compatible 工具通常使用带 /v1 的地址
模型名	gpt-5.5	以价格页面或当前分组支持的模型为准
测试消息	你好，请只回复：kapibalaAPI 已连接	可以直接复制这句话

TIP

如果你不确定模型名，先到价格页面或模型列表里确认当前分组支持哪些模型。调用不同模型时，通常只需要修改请求体里的 model 字段。

第 2 步：发送测试请求

如果你已经会用终端，可以直接使用下面的 cURL 示例。

请把 sk-你的密钥 替换成你真实的 API Key：

curl "https://kapibala.asia/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好，请只回复：kapibalaAPI 已连接"
      }
    ]
  }'

如果你在 Windows PowerShell 里测试，也可以用 curl.exe，避免 PowerShell 把 curl 当成其它命令：

curl.exe "https://kapibala.asia/v1/chat/completions" `
  -H "Authorization: Bearer sk-你的密钥" `
  -H "Content-Type: application/json" `
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "你好，请只回复：kapibalaAPI 已连接"
      }
    ]
  }'

第 3 步：看返回结果

成功时，模型回复里应该包含：

kapibalaAPI 已连接

如果返回的是 JSON，重点看 choices 字段里的消息内容。只要能看到模型按要求回复，就说明请求已经成功发到模型并拿到了结果。

如果失败，先看错误信息

不要一失败就同时改很多配置。先看状态码和错误文字，再按下面的方向排查：

现象	最可能原因	下一步
401	API Key 没填、填错，或缺少 Bearer	回 API Key 页面重新复制完整密钥
403	分组权限、IP 限制或账号条件不满足	检查 Key 绑定分组、IP 限制和账户状态
404	接口路径写错	确认使用 /v1/chat/completions
429	并发或速率限制触发	降低请求频率，稍后重试
模型不存在	model 不属于当前分组	从模型列表或价格页面重新确认模型名
余额不足	账户余额不够	充值后再测试

WARNING

不要把真实 API Key 发到聊天、截图、文章或代码仓库里。排查问题时，可以只保留 sk-... 的开头格式，隐藏后面的真实内容。

成功标准

完成这一页后，你应该已经：

1. 使用 kapibalaAPI 发出第一条测试消息。
2. 收到包含 kapibalaAPI 已连接 的回复。
3. 知道失败时先看状态码和错误文字。
4. 确认后续客户端配置可以继续使用同一个 API Key、请求地址和模型名。