基础认知
分清接口地址、API Key、模型与协议，知道 CC Switch 中什么时候要加 /v1。
先记住这个地址
omyai 中转站：https://omyai.vip
不同工具连接同一个平台，但使用的协议和地址格式可能不同。配置时，先看客户端要求，再填写地址。
接入只需要看懂三项
| 配置项 | 可以理解为 | 怎么填写 |
|---|---|---|
| Base URL | 请求发往哪里 | omyai 接口地址，是否带路径见下方对照表。 |
| API Key | 用哪把密钥鉴权和扣费 | 在 API 密钥页面 创建并复制，填入工具的密钥栏。 |
| Model | 这次调用哪个模型 | 选择所属分组支持的模型，手动填写时使用完整模型 ID。 |
同一个域名，不代表所有模型都能调用。 密钥所属分组决定可用模型和计费倍率；配置 Claude 与 GPT 时，要分别选择对应的分组。
四种接口，分开看
协议就是客户端与模型之间的“沟通格式”。OpenAI 的 Chat Completions 和 Responses 要分别选择，不要合并成一个“OpenAI 兼容”选项来理解。
| 接口类型 | 常见用途 | 基础地址 Base URL | 请求路径 |
|---|---|---|---|
| OpenAI · Chat Completions | 支持 Chat 接口的聊天客户端 | https://omyai.vip/v1 |
/v1/chat/completions |
| OpenAI · Responses | Codex、支持 Responses 的应用 | https://omyai.vip/v1 |
/v1/responses |
| Anthropic · Messages | Claude Code | https://omyai.vip |
/v1/messages |
| Gemini · 原生接口 | Gemini CLI 等原生客户端 | https://omyai.vip |
/v1beta/models/模型名:generateContent |
CC Switch 速记：Codex 选 Responses，加
/v1；Claude Code 不加；Gemini 原生配置不加。上表按对应客户端的配置习惯填写。其他工具可能自动补路径，优先看字段说明；各接口与模型是否可用，以平台和当前分组支持情况为准。
OpenAI · Chat Completions：按消息列表对话
适合：已经支持 Chat Completions 的聊天工具或应用。 通常由客户端把用户消息、助手回复等组成 messages 列表，发送给模型。
- 完整请求地址：
https://omyai.vip/v1/chat/completions - 主要输入：
messages，每条消息包含角色和内容。 - 返回形式：
choices中的助手消息；工具调用也有对应的字段格式。
客户端如果让你选择“Chat Completions”或“OpenAI Chat”，选这个接口。不要在 Base URL 中追加 /chat/completions，除非字段明确要求完整请求地址。
OpenAI · Responses：统一处理输入、输出与工具调用
适合：Codex 和明确支持 Responses 的应用。 它以 input 接收输入，以 output 返回消息、工具调用等不同类型的结果。
- 完整请求地址：
https://omyai.vip/v1/responses - 主要输入：
input，可包含文本或结构化输入项。 - 返回形式：
output项列表，不能按 Chat 的choices格式直接读取。
Responses 还提供会话衔接和内置工具等能力，但通过中转站能用哪些功能，需要看平台适配和模型支持。配置 Codex 时，选择 Responses；其他工具只有明确支持这一接口时才选择它。
两者最容易混淆的地方
| 对比项 | Chat Completions | Responses |
|---|---|---|
| Base URL | https://omyai.vip/v1 |
https://omyai.vip/v1 |
| 接口路径 | /chat/completions |
/responses |
| 主要输入字段 | messages |
input |
| 主要输出字段 | choices |
output |
| 接入时怎么选 | 工具要求 Chat 接口时选它 | Codex 或工具要求 Responses 时选它 |
地址前缀相同，不代表接口可以互换。 只修改模型名称或把路径换成
/responses，无法把一个只支持 Chat 的客户端变成 Responses 客户端。
接口差异参考 OpenAI 官方文档：迁移到 Responses。
Anthropic 与 Gemini：按客户端原生协议配置
Claude Code 使用 Anthropic Messages，按它的原生配置填写域名，由客户端拼接 /v1/messages。Gemini 原生客户端则使用自己的模型路径和请求格式，不应直接套用 OpenAI Chat 或 Responses 的配置。
模型品牌和协议也不是一回事：选 Claude 模型，不代表客户端一定使用 Anthropic 协议。 有些工具通过兼容接口调用其他品牌模型，是否可用取决于平台适配和分组支持。
为什么有的加 /v1，有的不加
Base URL 是基础地址，不是完整请求地址。 客户端会在它后面拼接具体的接口路径。
Codex
https://omyai.vip/v1 + /responses
→ https://omyai.vip/v1/responses
Claude Code
https://omyai.vip + /v1/messages
→ https://omyai.vip/v1/messages
Gemini 原生客户端
https://omyai.vip + /v1beta/models/模型名:generateContent
→ https://omyai.vip/v1beta/models/模型名:generateContent不要把完整请求地址填进 Base URL。 例如，把
/v1/messages填进去后，客户端继续拼接路径，就可能出现重复路径和404。上面的拼接用于说明原理，无需自己输入完整请求路径。使用 CC Switch 自动导入时，确认地址与客户端对应即可。
配好了，但连接不上？
| 现象 | 先检查 |
|---|---|
| 404 / 路径不存在 | 是否多填或漏填 /v1，是否把完整请求路径当成了 Base URL。 |
| 401 / 密钥无效 | Key 是否完整、是否启用，复制时有没有多余空格。 |
| 模型不可用 / 没有权限 | 密钥分组是否正确，模型 ID 是否在当前分组的可用列表中。 |
| 能聊天，但工具调用失败 | 客户端协议与模型能力是否匹配；能返回文本不代表支持全部工具功能。 |
完成配置后，重新打开客户端或命令行会话，发送一句简单的测试消息，再到 omyai 使用日志 确认实际调用的模型和费用。