Skip to content

通用 OpenAI 客户端

任何支持“自定义 OpenAI 接口”或“OpenAI Compatible”的客户端,通常都可以接入。

配置值

客户端字段推荐填写
API Key / Token控制台创建的令牌
Base URL / Endpointhttps://coffeecatbox.cc/v1
API Host / Server Addresshttps://coffeecatbox.cc
Chat Completions URLhttps://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 输出;
  • 推理强度参数;
  • logprobsseed 等扩展参数。

然后仅保留 modelmessagesstream 做最小测试。

本站为猫咖啡 API 使用文档。请合法、合规使用 AI 服务。