Cherry Studio 把 apimodels 当成一个 OpenAI 兼容服务商接入,一个 API key 就能用我们全部的聊天模型(GPT-5.5、Claude、Gemini、GLM 等)和图片模型(gpt-image-2)。本页给出完整配置和排错。
在 Cherry Studio 新增一个 OpenAI 类型的服务商,API 地址填 https://apimodels.app/api/v1/(结尾带斜杠很关键),密钥填你的 sk_… key,模型填 gpt-5-5 或 gpt-image-2。
到 控制台 控制台新建一个 sk_… 字符串。
Cherry Studio → 设置 → 模型服务 → 添加,类型选 OpenAI。API 地址和密钥见下。
点「检查连接」通过后,从模型列表选 gpt-5-5 聊天,或建一个画图助手用 gpt-image-2。
| 字段 | 填什么 |
|---|---|
| 服务商类型 | OpenAI |
| API 地址 / Host | https://apimodels.app/api/v1/ |
| API 密钥 | 你的 sk_… key |
| 模型 | gpt-5-5 · gpt-5-4 · claude-opus-4-8 · gemini-3-pro-preview · gpt-image-2 … |
⚠️ API 地址结尾一定要带斜杠:填 https://apimodels.app/api/v1/(带 /)。如果不带斜杠,Cherry Studio 会自动再拼一个 /v1,变成 …/api/v1/v1/… 导致连接失败。或者也可以填 https://apimodels.app/api 让它自己补 /v1。
完整列表会出现在 Cherry Studio 的模型下拉里(我们的 /v1/models 端点),常用的有:
| 用途 | 模型 ID |
|---|---|
| 聊天 / 编码 | gpt-5-5 · gpt-5-4 · claude-opus-4-8 · gemini-3-pro-preview · glm-5.2 · MiniMax-M2.5 |
| 文生图 / 改图 | gpt-image-2 · gemini-3-pro-image-preview · gemini-2.5-flash-image |
gpt-image-2 走标准 OpenAI 图片接口 /v1/images/generations。在 Cherry Studio 里建一个「画图助手」选 gpt-image-2 即可;尺寸用 1024x1024 这种 宽x高 格式。我们会同步返回 b64_json(无需轮询),Cherry Studio 直接显示。
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"
}'连不上时,先用 curl 确认 key 和端点本身没问题(这正是 Cherry Studio 检查连接时打的 /models):
# 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再测一条聊天:
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" }]
}'| 症状 | 原因 / 修法 |
|---|---|
| 检查连接失败 / 拉不到模型 | API 地址结尾没带斜杠,被拼成了 …/api/v1/v1/…。改成 https://apimodels.app/api/v1/(带 /)。 |
| HTTP 401 | key 错了或被禁用。去控制台新建一个 sk_… 重填。 |
| 模型选了没反应 / 400 Unknown model | 模型 ID 拼错。用横杠形式,如 gpt-5-5、gpt-image-2(见上表)。 |
| 画图很久才出 / 看似卡住 | gpt-image-2 出图本身要几十秒,我们同步等待返回,属正常,不是卡死。 |