OpenAI 兼容接口

猫咖啡 API 提供 OpenAI 兼容的 REST 接口，可用于现有 SDK、客户端和后端服务。

Base URL: https://coffeecatbox.cc/v1

认证

每个请求都通过 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

令牌请放在服务端环境变量中，不要写进浏览器代码或提交到代码仓库。

对话补全

POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

最小请求：

curl https://coffeecatbox.cc/v1/chat/completions \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "控制台中的模型名",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手。"},
      {"role": "user", "content": "什么是 API 网关？"}
    ],
    "stream": false
  }'

常用参数

参数	类型	说明
model	string	必填，控制台中可用的模型标识
messages	array	必填，对话消息列表
stream	boolean	是否使用流式输出
temperature	number	随机性；并非所有模型都支持
max_tokens	number	最大输出 Token；部分新模型使用其他参数名
tools	array	工具定义；仅支持工具调用的模型可用

不同上游模型支持的参数并不完全一致。遇到 400 时，先删除可选参数，仅保留最小请求。

消息角色

{
  "messages": [
    { "role": "system", "content": "设定助手行为" },
    { "role": "user", "content": "用户输入" },
    { "role": "assistant", "content": "历史助手回复" }
  ]
}

部分模型可能使用 developer 等新角色。是否支持以模型实际能力为准。

获取模型列表

curl https://coffeecatbox.cc/v1/models \
  -H "Authorization: Bearer $NEWAPI_API_KEY"

模型列表接口返回的内容受令牌分组和权限影响。控制台模型广场通常会提供更完整的能力与价格说明。

响应中的请求 ID

排查问题时，请记录响应头或错误响应中的请求 ID，以及请求时间和模型名。联系管理员时不要发送完整令牌。