主题
通用配置(OpenAI 兼容)
云桥提供标准 OpenAI 兼容接口。凡是允许自定义 OpenAI 接口地址(Base URL)的客户端,都可以接入,原理一致:
| 配置项 | 填写值 | 说明 |
|---|---|---|
| Base URL / API 地址 / 接口端点 | https://codexgemini.cc/v1 | 部分客户端只需填到 https://codexgemini.cc,由其自动补 /v1,详见各客户端说明 |
| API Key / 密钥 | 你的密钥(控制台「密钥」页复制) | 鉴权头为 Authorization: Bearer <密钥>,客户端通常自动处理 |
| 模型 / Model | gpt-5.4 等 | 见可用模型 |
填 Base URL 的常见坑
不同客户端对地址的要求略有差异:
- 多数客户端:填
https://codexgemini.cc/v1 - 少数客户端会自动追加
/v1:此时只填https://codexgemini.cc - 若客户端要求填「完整端点」如 chat completions:填
https://codexgemini.cc/v1/chat/completions
如果调用报 404 / Not Found,多半是 /v1 多填或少填了,按上面三种情形调整即可。
验证是否接通
任选一个模型发一句「你好」,能正常回复即接通。命令行验证见快速开始第 3 步。
下一步
挑你用的客户端:Codex CLI · Cherry Studio · Chatbox / 其它 · 代码调用
