OpenAI-Compatible 到底表示什么
兼容 provider 通常能接收 OpenAI 风格请求，但不同工具依赖的端点、模型 ID、流式事件、错误格式和鉴权行为不一样。兼容性只能作为初筛，不是保证。
Base URL 核对清单
- 确认 Base URL 应该填网关根路径、`/v1`，还是 provider 专属路径。
- 不要把完整的 `/chat/completions`、`/responses` 或 `/models` 端点填进 Base URL。
- 确认 provider 是否支持 `/v1/models`，方便工具发现可用模型 ID。
- 记录实际测试的完整模型 ID，而不只是 GPT、Claude、DeepSeek 这类模型族名称。
- 如果工作流依赖流式输出、工具调用、JSON mode 或错误重试，必须单独测试这些行为。
按工具分别核对
- Cursor 自定义 Key 可能只覆盖部分聊天工作流，一些专用能力仍可能走 Cursor 内置模型路径。
- Codex CLI 自定义 provider 可能需要 Responses 风格兼容，而不只是 Chat Completions。
- Cline 和 OpenAI SDK 通常重点核对 `/v1`、模型 ID、流式输出和可重试错误格式。
- Claude Code 通常需要 Anthropic-compatible 行为；仅有 OpenAI-compatible 端点通常不够。
- 如果 provider 有专门的 Cursor、Codex CLI、Cline 或 SDK 文档，优先按专门文档测试。
价格和模型证据
网关价格会受到 provider route、缓存读写、上下文长度、图片/音频计费和失败请求影响。测试前先保存价格页、模型列表和 provider route 说明，后续扣费差异才有依据。
- 把价格统一换算为每 1M input tokens 和每 1M output tokens。
- 模型支持缓存时，单独核对 cache write/read 价格。
- 查看最低充值、退款规则、失败请求扣费和限速说明。
- 如果同一模型有多个 provider route，记录实际选择的 route。
- 保存一条小测试 prompt 和扣费截图，方便后续对照。
小额测试流程
- 先打开 provider 文档、价格、模型列表、隐私政策、服务条款、状态页和支持入口。
- 用公开来源检查工具记录缺失字段，再决定是否加 Key。
- 用最低余额或免费额度做无敏感信息测试。
- 测试模型列表、短对话、流式输出、小代码任务和一次故意错误。
- 只有当端点、模型 ID 和扣费行为都与文档一致时，再把 Key 固化到编辑器或 CLI。
什么时候不该用第三方网关
涉及私有仓库、生产密钥、客户数据或合规要求时，除非 provider 能提供可信的数据处理和合同路径，否则不建议走第三方网关。
敏感工作优先使用官方 API、云厂商渠道、企业网关或自建 BYOK 基础设施。Relay provider 更适合公开代码、小额验证和低风险实验。
常见问题
OpenAI-compatible 等于官方 OpenAI 吗？
不等于。它通常只表示请求形态接近 OpenAI API，上游模型、扣费、隐私控制、限速和错误行为都可能不同。
Base URL 一定要带 /v1 吗？
不一定。有些 provider 要求填网关根路径，有些要求填 `/v1`。最稳妥的做法是看当前文档，并且不要把 `/v1/chat/completions` 这类完整端点填进 Base URL。
所有 OpenAI-compatible provider 都能用于 Cursor 吗？
不能。Cursor 是否可用取决于当前设置界面、支持的模型类型、Base URL 覆盖行为，以及该工作流是否仍走 Cursor 内置模型路径。
充值前最应该确认什么？
先确认文档、价格、模型 ID、隐私政策、服务条款、状态页和支持入口，再用小额无敏感测试对照公开价格页检查扣费。