APIrove

Home / API docs / 3-step setup

LEAST HASSLE · JUST COPY

Don't fuss with settings
Copy this and send it to your chat

You only need to do three things: copy → send it to Codex / your chat assistant → click where it tells you. You don't need to learn a pile of jargon first.

Beginner guide · For the impatient · About 1 minute. Copy first, then do the rest. Updated November 4, 2026.

Need fuller endpoint details or a checklist? See the pro guide.

First, know the two kinds of key (don't mix them up)

  • Text group (文本组 · default for new customers · named APIrove-Text): for CCSwitch / Codex chat, and it can also generate images (Codex defaults to Image 2.6).
  • Full group (完整组 · named APIrove-Unified): chat, images, and broader capabilities such as Claude. Choose this when you want the full bundle; images also work on the text group.

Existing customers: the keys you already have don't need to change. For a new key: mostly chat → choose the text group, which can also generate images (Codex defaults to Image 2.6); choose the full group when you also need broader capabilities such as Claude.

① Copy this first (most important)

Click the green button below. Copy the whole thing → paste it into the chat / Codex / chat assistant you're using. Then say: “Set me up according to this.”

It will walk you through filling in the address and key. Just follow along and click.

Full message to send to your chat / Codex
Please set up my client (CCSwitch / Codex / chat tool) using the rules below. Once it is set up, follow the same rules in later conversations too.

1) Endpoint address (enter it once)
Base URL = https://apirove.com/v1
API Key = my own APIrove key
Request header: Authorization: Bearer MY_KEY

2) Which key to use
- Chat / CCSwitch / Codex: prefer a "text group" key (in the console it is usually named APIrove-Text). Its chat models are all GPT text models; the same key can also generate images (Codex defaults to Image 2.6).
- To make images: a text-group or full-group key both work. Codex image generation uses Image 2.6 (gpt-image-2.6-flare) by default, with no extra key setup; to turn it off, clear the checkbox on the console keys page. The full group has broader capabilities (including Claude).
- Old keys do not need to be replaced.

3) Chat
Use only GPT text models, for example: gpt-6.1-sol, gpt-5.6-terra, gpt-6-astra
Do not use a model with "image" in its name for chat

4) Making images (text-group or full-group keys both work)
Do not use the chat endpoint.
Use: POST https://apirove.com/v1/images/generations
Example model: gpt-image-2.6-flare (also the default when model is omitted)
If the current app cannot make images, give me a curl command I can copy and run directly.

5) Notes
Do not post the key in group chats or screenshots, or put it in public code.
When setup is done, tell me in one sentence whether the address, key type (text group / full group), and chat model are all set.

Does your app only have a short “system prompt” field? Use this short version:

Short version (fits a system prompt field)
APIrove: address https://apirove.com/v1 + my key. For chat, prefer the text group (APIrove-Text) and choose only GPT text models (e.g. gpt-6.1-sol). Do not chat with gpt-image-*. To make images, use a text-group or full-group key + POST /v1/images/generations. Codex defaults to Image 2.6 (gpt-image-2.6-flare); the API also uses it when model is omitted.

② Get a key (API key)

Key = your access password. Without it, calls won't go through.

  1. Open Create API key and make a new one.
  2. For the group, choose APIrove-Text (text group) first; it can also generate images. Choose APIrove-Unified (full group) when you also need broader capabilities such as Claude.
  3. Copy it and keep it safe. Don't post it in group chats or take screenshots of it.
  4. In CCSwitch / Codex: enter the address below and paste in the key.
Endpoint address (Base URL)
https://apirove.com/v1
Just remember this: text group for chat; image generation works with a text-group or full-group key, and Codex defaults to Image 2.6. Old keys don't need to change.

③ Which model to choose for chat

Model = the name of the AI you're calling in to do the work.

  • Chat: choose a GPT text model. Common picks: gpt-6.1-sol, gpt-5.6-terra.
  • Text group: the list is basically all chat models, so picking one is easy.
  • Don't choose: anything with image in the name (those are for making images, not for chat).

④ Want to make images?

In Codex, image generation uses Image 2.6 (gpt-image-2.6-flare) by default, with no extra key setup. To turn it off, clear the checkbox for that key on the console keys page.

API image calls can use a text-group or a full-group key. Images don't go through “chat”; they use a dedicated endpoint:

POST /v1/images/generations · the default model is Image 2.6 (gpt-image-2.6-flare), also used when model is omitted. Images Codex generates while you chat default to Image 2.6 too.

If your app can make images: use the same address and the same text-group or full-group key.
It can't? Send section ① above to your assistant and ask it for a command you can copy. Or just copy the one below (this is an Images API example using Image 2.6, gpt-image-2.6-flare):

Image command (replace YOUR_API_KEY with your 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
  }'
Images still use the same text-group or full-group key and the same address. When there is occasional instability, the system automatically switches routes and tries again; you don't need to change your settings or your key.

Stuck? Just check these

  • 401 / says no permission: the key wasn't pasted correctly, or part of it is missing. Copy the key again.
  • Chat acts strange / shows errors: did you pick gpt-image-* by mistake? Switch back to a GPT text model, or use a text-group key.
  • Image request returns 404 / no image models: first check the keys page to see whether image generation was turned off for that key. The text group can generate images too (Codex defaults to Image 2.6). If it still fails, try a full-group key.
  • Not sure how to set it up: go back to step ①, copy that message to Codex, and let it walk you through it click by click.

Still not working? First check that your account has a balance: console. Model list: model directory. Full endpoint details: API docs.