通用 OpenAI 客户端
任何支持“自定义 OpenAI 接口”或“OpenAI Compatible”的客户端,通常都可以接入。
配置值
| 客户端字段 | 推荐填写 |
|---|---|
| API Key / Token | 控制台创建的令牌 |
| Base URL / Endpoint | https://coffeecatbox.cc/v1 |
| API Host / Server Address | https://coffeecatbox.cc |
| Chat Completions URL | https://coffeecatbox.cc/v1/chat/completions |
| Model | 控制台中的准确模型标识 |
地址判断规则
客户端最终应请求:
text
https://coffeecatbox.cc/v1/chat/completions根据实际结果调整:
| 最终请求地址 | 处理方式 |
|---|---|
/v1/chat/completions | 正确 |
/v1/v1/chat/completions | 配置地址删除 /v1 |
/chat/completions | 配置地址增加 /v1 |
/v1/models | 正确的模型列表接口 |
最小连通性测试
配置客户端前,可先在终端验证令牌和模型:
bash
curl https://coffeecatbox.cc/v1/chat/completions \
-H "Authorization: Bearer $NEWAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "控制台中的模型名",
"messages": [{"role": "user", "content": "回复 OK"}]
}'如果 curl 成功而客户端失败,问题通常在客户端地址拼接、模型设置或额外参数。
不兼容的功能
OpenAI 兼容并不意味着每个模型都支持所有参数。出现参数错误时,尝试关闭:
- 图片或文件输入;
- 工具调用;
- JSON Schema 输出;
- 推理强度参数;
logprobs、seed等扩展参数。
然后仅保留 model、messages 和 stream 做最小测试。