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.6-sol · gpt-5.6-terra · gpt-5-5 · 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.6-sol · gpt-5.6-terra · gpt-5.6-luna-max · gpt-5-5 · claude-opus-4-8 · gemini-3-pro-preview · glm-5.2 · MiniMax-M2.5 |
| 文生图 / 改图 | gpt-image-2 · gemini-3.1-flash-image-preview (Nano Banana 2) · gemini-3-pro-image-preview (Nano Banana Pro) · grok-imagine-image · doubao-seedream-5-0-pro · kling-v3 |
图片模型和聊天模型用同一个服务商、同一个 API 地址,不需要第二个渠道、也不需要在地址后面加 # 之类的技巧。在普通对话里把模型切成 gpt-image-2(或 gemini-3.1-flash-image-preview、grok-imagine-image 等),直接把画面描述发出去,图片会作为回复里的一张图出现。
curl -s https://apimodels.app/api/v1/chat/completions \
-H "Authorization: Bearer $APIMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"messages": [{ "role": "user", "content": "a cute corgi puppy on grass" }]
}'
# → assistant message containing: 在同一条消息里附带一张图,就是图生图 / 改图 —— 描述你要改什么即可。注意:每条消息独立成图,上一轮的图不会被自动当作参考,所以「画只猫」之后再「画只狗」不会串味;要基于上一张改,请把那张图重新附上。
需要程序化调用(自己控制尺寸、张数、回调)时,标准的 OpenAI 图片接口仍然可用:
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(见上表)。 |
| 画图很久才出 / 看似卡住 | 出图本身要 10–90 秒,我们会一直等到图片生成完再返回(流式下持续保活),属正常,不是卡死。 |
| API 地址填了完整端点 → 404 | Cherry Studio 会在你填的地址后面继续拼路径。填 …/api/v1/images/generations 会变成 …/images/generations/chat/completions(不存在)。只填到 https://apimodels.app/api/v1/。地址框下方的「预览」那行就是最终 URL,配完先看一眼。 |
| 「没有可以被检测的模型(例如对话模型)」 | 模型列表还是空的(模型 0),先用 + 添加一个模型再检测。这个提示不代表 key 或地址有问题。另外注意:选中图片模型点检测,会真的生成一张图并计费,用聊天模型检测更省。 |
| 「AI 绘画 / 图像」模块里选不到我们 | 这是 Cherry Studio 自身的限制:自定义服务商的图片模型进不了绘画模块(官方 issue 已标记 not planned)。改在普通对话里选图片模型即可,效果一样。 |