「OpenAI 兼容」指什么
通常指实现（或近似实现）OpenAI 的 HTTP API 形状，例如
POST /v1/chat/completions，以及类似的请求/响应 JSON 字段
（model、messages、choices 等）。
客户端只要允许改「API 地址」，把官方 https://api.openai.com/v1
换成网关地址即可，无需改业务代码。
兼容到什么程度算「能用」
- 能用你的 Key 调通
/v1/chat/completions
- 目标模型在网关模型列表里存在
- 流式（stream）、tool calls 等按你的场景验证（网关可能有差异）
- 错误码与重试行为可被你的客户端处理
HardysAPI 支持的两套协议
/messages
Anthropic 兼容
x-api-key
最小验证（3 分钟）
- 注册 HardysAPI，创建 Key
- 用 cURL 打一发 chat/completions
- 确认返回 200 后，再配置 Claude Code / Cursor / 自研服务
完整代码：通用 API 接入。
常见不兼容点
- Base URL 忘记带
/v1 → 404
- 把 OpenAI 的 Bearer 写成 Anthropic 的 x-api-key → 401
- 模型 id 写了官网未映射的版本号 → model not found
- 超时设置过短 → 长上下文场景误判失败（失败不扣费，可重试）