APIrove

首页 / API 文档 / 3 步接通

最省事 · 复制就能用

别纠结设置
复制这段,发给你的对话

你只要做三件事:复制 → 发给 Codex / 对话助手 → 按它说的点几下。不用先搞懂一堆名词。

小白版 · 写给没耐心的人 · 约 1 分钟。先复制,再动手。更新:2026-11-04。

需要更完整的接口说明、核对清单?看 专业版。

先看清:两种 Key(别混)

  • 文本组(新客默认 · 名字叫 APIrove-Text):给 CCSwitch / Codex 聊天用,也可以出图(Codex 默认 Image 2.6)。
  • 完整组(名字叫 APIrove-Unified):聊天、出图,以及 Claude 等更全能力。需要全家桶时选这个;只出图用文本组也可以。

老客户手里那几把 Key 不用换。新开 Key:聊天为主就选文本组,文本组也可以出图(Codex 默认 Image 2.6);需要 Claude 等更全能力再开完整组。

① 先复制这段(最重要)

点下面绿色按钮。复制整段 → 粘贴给你正在用的对话 / Codex / 聊天助手。然后说一句:「按这段帮我配好」。

它会带着你填地址和 Key。你跟着点就行。

发给对话 / Codex 的整段话
请按下面规则帮我配置客户端(CCSwitch / Codex / 对话工具)。配好后,后面对话也按这个来。

1)接口地址(只填一次)
Base URL = https://apirove.com/v1
API Key = 用我自己的 APIrove Key
请求头:Authorization: Bearer 我的Key

2)选哪种 Key
- 聊天 / CCSwitch / Codex:优先用「文本组」Key(控制台里名字常是 APIrove-Text)。聊天模型都是 GPT 文字模型;同一把 Key 也可以出图(Codex 默认 Image 2.6)。
- 要画图:文本组或完整组都可以。Codex 出图默认 Image 2.6(gpt-image-2.6-flare),密钥无需额外开通;要关闭就到控制台密钥页面取消勾选。完整组能力更全(含 Claude 等)。
- 老 Key 不用换。

3)聊天
只用 GPT 文字模型,例如:gpt-6.1-sol、gpt-5.6-terra、gpt-6-astra
不要用名字里带 image 的模型来聊天

4)画图(文本组或完整组都可以)
不要走聊天接口。
请用:POST https://apirove.com/v1/images/generations
模型示例:gpt-image-2.6-flare(不写 model 也默认用它)
如果当前软件不会画图,就给我一条能直接复制的 curl 命令。

5)注意
不要把 Key 发到群里、截图,或写进公开代码。
配完后用一句话告诉我:地址、Key 类型(文本组/完整组)、聊天模型是否都好了。

软件里只有很短的「系统提示词」栏?用这一小段:

短版(塞系统提示词栏)
APIrove:地址 https://apirove.com/v1 + 我的 Key。聊天优先用文本组(APIrove-Text),只选 GPT 文字模型(如 gpt-6.1-sol)。不要用 gpt-image-* 聊天。要画图可用文本组或完整组 + POST /v1/images/generations。Codex 出图默认 Image 2.6(gpt-image-2.6-flare);API 不写 model 时也默认用它。

② 准备一张 Key(密钥)

Key = 你的通行证密码。没有它,调不通。

  1. 打开 创建 API Key,新建一张。
  2. 分组优先选 APIrove-Text(文本组),文本组也可以出图。需要 Claude 等更全能力再选 APIrove-Unified(完整组)。
  3. 复制保存好。别发群、别截图。
  4. 在 CCSwitch / Codex 里:地址填下面这个,Key 贴进去。
接口地址(Base URL)
https://apirove.com/v1
记一句就行:聊天用文本组;出图可用文本组或完整组,Codex 默认 Image 2.6。老 Key 不用换。

③ 聊天怎么选模型

模型 = 你要喊来干活的 AI 名字。

  • 聊天:选 GPT 文字模型。常用:gpt-6.1-sol、gpt-5.6-terra。
  • 文本组:列表里基本都是聊天模型,点起来省心。
  • 别选:名字带 image 的。那是画图用的,不要拿来聊天。

④ 要画图呢

在 Codex 里出图默认使用 Image 2.6(gpt-image-2.6-flare),密钥无需额外开通。如需关闭,到控制台密钥页面按密钥取消勾选即可。

API 画图也可以用文本组或完整组 Key。画图不走「聊天」,走专门接口:

POST /v1/images/generations · 默认模型 Image 2.6(gpt-image-2.6-flare),不写 model 也用它;Codex 对话出图同样默认 Image 2.6。

你的软件如果会画图:还是同一个地址、同一张文本组或完整组 Key。
不会?把上面第 ① 段发给助手,让它给你一条可复制命令。或直接复制下面(这是 Images API 示例,模型用 Image 2.6 gpt-image-2.6-flare):

画图命令(把 YOUR_API_KEY 换成你的 Key)
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
  }'
出图还是同一把文本组或完整组 Key、同一个地址。偶发不稳定时,系统会自动换路再试,你不用改配置、也不用换 Key。

卡住了?只看这几条

  • 401 / 说没权限:Key 没贴对,或贴少了。重新复制 Key。
  • 聊天很怪 / 报错:是不是选成了 gpt-image-*?改回 GPT 文字模型;或换文本组 Key。
  • 画图 404 / 没有 image 模型:先看密钥页面是否关闭了出图。文本组现在也可以出图(Codex 默认 Image 2.6)。若仍不行,再试完整组 Key。
  • 不会设:回到第 ① 步,复制那段发给 Codex,让它一步步带你点。

还不行?先确认账户有余额:控制台。模型名单:模型目录。完整接口说明:API 文档。