OpenAI Compatible API
OpenAI 兼容 API 是什么？
很多 AI 客户端会用 OpenAI 风格的接口字段，例如 base_url、API Key 和 model。ZZSwitch 提供 OpenAI 兼容入口，但不同工具并不总是填写同一个地址。
base_url 是什么
base_url 是客户端发起 API 请求时使用的基础地址。OpenAI 兼容客户端通常填写 https://api.zzswitch.com/v1，客户端会继续拼接 chat/completions、responses 或 models 等路径。
为什么有些地址要带 /v1
OpenAI 兼容接口通常把版本号放在 /v1 下。Codex、OpenCode、Cline、Cherry Studio 这类按 OpenAI 兼容 provider 配置的工具，一般使用 /v1 地址。
什么时候不要带 /v1
如果工具明确要求 Claude/CC 类根地址，或者配置说明要求填写服务根地址，则使用 https://api.zzswitch.com。不要把 Codex 的 /v1 配置直接套到所有工具。
API Key 和 Token 的关系
在 ZZSwitch 中，API Key 通常就是你在令牌页面创建的 Token。Token 代表调用权限，不要公开分享、截图传播或提交到 Git 仓库。
实时模型和价格在哪里看
模型列表、倍率、调用排行榜和真实扣费记录依赖 new-api 实时数据，应以控制台为准，静态官网只解释规则和入口。