APIrove

首页 / API 文档 / 专业版对接

专业版 · 完整对接说明

CCSwitch / Codex 对接说明(专业版)

双入口:文本组给 CCSwitch / Codex 聊天(也可出图,默认 Image 2.6);完整组给更全的 API 能力(含 Claude 等)。在客户端配一次 Base URL 与 Key,再复制下方提示词发给对话模型 / Codex。

客户对接教程 · 2026-11-04。面向 CCSwitch、Codex / ChatGPT 桌面端及其他支持自定义 Base URL 的对话客户端。

没耐心看专业说明?先看 小白版(复制就能用),配好再回这里查细节。

0. 文本组 vs 完整组

分组控制台名称适合谁/v1/models 里有什么
文本组(新客默认)APIrove-TextCCSwitch / Codex / 纯聊天,也可出图GPT 聊天模型;也可出图(Codex 默认 Image 2.6)
完整组APIrove-UnifiedAPI 调用、要出图、要 Claude文本 + Claude + Image
  • 新建 Key 时:聊天为主选 APIrove-Text(文本组也可以出图,Codex 默认 Image 2.6);需要 Claude 等更全能力再选 APIrove-Unified。
  • 已有客户 Key(含 gift Key)不轮换、不改绑;仍在原分组上继续用。
  • 自助 / 批量开 Key 默认绑文本组;需要完整能力时在控制台另建完整组 Key,或联系客服加开。

1. 配一次:Base URL + Key

  1. 在 API Key 管理创建 Key,并选对分组(见上表)。
  2. 在 CCSwitch / Codex / 同类客户端里把 API 地址设为:
Base URL
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 未写入公开仓库 / 截图