客户对接教程 · 2026-11-04。面向 CCSwitch、Codex / ChatGPT 桌面端及其他支持自定义 Base URL 的对话客户端。
没耐心看专业说明?先看 小白版(复制就能用),配好再回这里查细节。
0. 文本组 vs 完整组
| 分组 | 控制台名称 | 适合谁 | /v1/models 里有什么 |
|---|---|---|---|
| 文本组(新客默认) | APIrove-Text | CCSwitch / Codex / 纯聊天,也可出图 | GPT 聊天模型;也可出图(Codex 默认 Image 2.6) |
| 完整组 | APIrove-Unified | API 调用、要出图、要 Claude | 文本 + Claude + Image |
- 新建 Key 时:聊天为主选 APIrove-Text(文本组也可以出图,Codex 默认 Image 2.6);需要 Claude 等更全能力再选 APIrove-Unified。
- 已有客户 Key(含 gift Key)不轮换、不改绑;仍在原分组上继续用。
- 自助 / 批量开 Key 默认绑文本组;需要完整能力时在控制台另建完整组 Key,或联系客服加开。
1. 配一次:Base URL + Key
- 在 API Key 管理创建 Key,并选对分组(见上表)。
- 在 CCSwitch / Codex / 同类客户端里把 API 地址设为:
https://apirove.com/v1
认证方式:Authorization: Bearer YOUR_API_KEY。Key 只放在客户端密钥栏或本机环境变量,不要发到群聊、截图或公开仓库。
2. 可复制提示词(发给对话模型 / Codex)
需要深度功能或让助手帮你改客户端配置时,把下面整段复制发出去。
完整版(推荐一键复制)
你是我的 API 配置助手。请严格按下列规则帮我配置客户端(CCSwitch / Codex / 对话客户端),并在后续对话中自动沿用:
【全局配置 · 只配一次】
- Base URL:https://apirove.com/v1
- API Key:使用我提供的 APIrove Key
- 认证头:Authorization: Bearer <API_KEY>
【Key 类型】
- 文本组(APIrove-Text,新客默认):/v1/models 只有 GPT 聊天模型,适合 CCSwitch / Codex
- 完整组(APIrove-Unified):含文本、Claude、生图;需要更全能力时用此组
- 老 Key 不要轮换;需要完整能力可另建完整组 Key
【默认聊天】
- 桌面对话 / 文本对话请使用 GPT 文本模型(例如 gpt-6.1-sol、gpt-5.6-terra、gpt-6-astra、gpt-6-sol、gpt-6.1-terra)
- 不要把生图模型(如 gpt-image-2.6-flare)当作聊天 / 对话模型
【出图】
- 文本组或完整组都可以
- 生图请走:POST https://apirove.com/v1/images/generations
- 模型示例:gpt-image-2.6-flare(不写 model 也默认用它)
- 若当前客户端不支持 images/generations:给出可复制的 curl / API 请求,不要把图模塞进聊天接口硬调
【安全】
- 不要把 Key 写入公开仓库、网页前端或截图
- 配置完成后用一句短回复确认:Base URL、Key 类型、默认聊天模型、出图路径是否已就位
精简版(系统 / 全局提示词栏)
客户端只有短系统提示词栏时,用这一段:
APIrove:Base https://apirove.com/v1 + 我的 Key。聊天优先文本组 APIrove-Text(GPT 如 gpt-6.1-sol / gpt-5.6-terra);勿把 gpt-image-* 当聊天模型。出图可用文本组或完整组 + POST /v1/images/generations。Codex 出图默认 Image 2.6(gpt-image-2.6-flare);API 不写 model 时也默认用它。
复制后把
<API_KEY> 换成你自己的 Key,或在客户端密钥栏单独填写(推荐后者,避免把 Key 贴进对话)。3. 默认聊天怎么选模型
- 文本组:列表应只有 GPT 聊天模型,直接选
gpt-6.1-sol/gpt-5.6-terra等。 - 完整组:列表可能同时出现 GPT、Claude、Image;桌面聊天请只选 GPT 文本模型。
- 不要用
gpt-image-*当对话模型。
更多已实测模型见 模型目录。
4. 出图用法
使用文本组或完整组 Key。生图不走聊天补全接口,请调用(下面 curl 是 Images API 示例,模型为 Image 2.6 gpt-image-2.6-flare,不写 model 也默认用它;Codex 对话出图同样默认 Image 2.6):
curl https://apirove.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "a simple red circle on white background",
"size": "1024x1024",
"n": 1
}'
在 Codex 里出图默认使用 Image 2.6(
gpt-image-2.6-flare),密钥无需额外开通。如需关闭,到控制台密钥页面按密钥取消勾选即可。Image 模型目录:/models/#image。文本组和完整组 Key 都可以出图。若返回模型不可用(如 404),先检查密钥页面是否关闭了出图。
对外仍是同一个 APIrove 地址与同一张文本组或完整组 Key;客户侧模型名不变(如 gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2.6-flare)。线路偶发抖动时,网关会自动切换可用路径,客户端无需改 Base URL、模型或 Key。
5. 核对清单
- Base URL =
https://apirove.com/v1 - 新建聊天 Key → 分组
APIrove-Text(也可出图,Codex 默认 Image 2.6);需要更全能力 →APIrove-Unified - 文本组聊天
gpt-6.1-sol等返回 200;也可出图(Codex 默认 Image 2.6) - 文本组或完整组均可
POST /v1/images/generations - 老客户现有 Key 未轮换
- Key 未写入公开仓库 / 截图