Use apimodels in Cherry Studio

Get connected in 3 steps

1. 1

   Grab an API key

   Open Console in your console and create an sk_… key.

2. 2

   Add an OpenAI provider

   Cherry Studio → Settings → Model Providers → Add, pick type OpenAI. API host + key below.

3. 3

   Pick a model

   After "Check connection" passes, pick gpt-5-5 to chat, or a gpt-image-2 painting assistant to generate images.

Provider settings

Common model IDs

The full list shows up in Cherry Studio's model dropdown (served by our /v1/models endpoint). The common ones:

Image generation (gpt-image-2)

gpt-image-2 uses the standard OpenAI image endpoint /v1/images/generations. In Cherry Studio create a painting assistant with gpt-image-2; use a 1024x1024 (width x height) size. We return b64_json synchronously (no polling), which Cherry Studio renders directly.

curl -s https://apimodels.app/api/v1/images/generations \
  -H "Authorization: Bearer $APIMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a cute corgi puppy on grass",
    "n": 1,
    "size": "1024x1024"
  }'

30-second sanity check

If it won't connect, confirm the key + endpoint with curl first — this is exactly what Cherry Studio hits on "check connection":

# confirm the endpoint + your key work (this is what Cherry Studio checks):
curl -s https://apimodels.app/api/v1/models \
  -H "Authorization: Bearer $APIMODELS_API_KEY" | head -c 300

Then a chat call:

curl -s https://apimodels.app/api/v1/chat/completions \
  -H "Authorization: Bearer $APIMODELS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-5",
    "messages": [{ "role": "user", "content": "Reply with exactly: ok" }]
  }'

Troubleshooting