API 概览

当前 content/api-reference 只保留仍与实现锚点对齐的本地兼容接口说明，不再继续扩写旧管理接口或未挂载的兼容路由叙事。

当前保留的兼容面

OpenAI 兼容

用于本地对话与模型发现：

• POST /v1/chat/completions
• GET /v1/models

查看 OpenAI API 说明 →

Claude 兼容

用于 Claude Messages 协议兼容：

• POST /v1/messages
• POST /v1/messages/count_tokens

查看 Claude API 说明 →

默认地址

默认本地地址：

http://127.0.0.1:8999

通常建议只在本地监听，不对公网直接暴露。

认证方式

认证头会跟随兼容协议变化：

• OpenAI 兼容：Authorization: Bearer <api-key>
• Claude 兼容：x-api-key: <api-key>，并携带 anthropic-version

具体请求示例以各协议子页面为准。

错误排查建议

• 401
  • 密钥错误
  • 认证头格式与协议不匹配
• 404
  • 路径错误
  • 协议路径写错
• 429
  • 请求频率过高
  • 上游限流
• 5xx
  • 本地服务异常
  • 上游模型服务波动

下一步

• OpenAI API
• Claude API