APIMODELSAPIMODELS
API 文档

apimodels.app

获取 API 密钥模型市场
OpenAI 兼容 · 聊天 + 图片 · 一个 key 全模型

在 Cherry Studio 里用 apimodels

Cherry Studio 把 apimodels 当成一个 OpenAI 兼容服务商接入,一个 API key 就能用我们全部的聊天模型(GPT-6.1 Sol、Claude、Gemini、GLM 等)和图片模型(gpt-image-2)。本页给出完整配置和排错。

一句话版

在 Cherry Studio 新增一个 OpenAI 类型的服务商,API 地址填 https://api.apimodels.app/v1/(结尾带斜杠很关键),密钥填你的 sk_… key,模型填 gpt-6.1-sol 或 gpt-image-2。

三步接入

  1. 1

    拿一个 API key

    到 控制台 控制台新建一个 sk_… 字符串。

  2. 2

    加 OpenAI 服务商

    Cherry Studio → 设置 → 模型服务 → 添加,类型选 OpenAI。API 地址和密钥见下。

  3. 3

    选模型开聊 / 出图

    用 + 手动添加模型,或点「获取模型列表」。聊天选 gpt-6.1-sol,出图选 gpt-image-2 —— 两者都在普通对话里用,不需要分开配。

服务商配置

字段填什么
服务商类型OpenAI
API 地址 / Hosthttps://api.apimodels.app/v1/
API 密钥你的 sk_… key
模型gpt-5.6-sol · gpt-5.6-terra · gpt-6.1-sol · claude-opus-5-5 · gemini-3-pro-preview · gpt-image-2 …

⚠️ API 地址结尾一定要带斜杠:填 https://api.apimodels.app/v1/(带 /)。如果不带斜杠,Cherry Studio 会自动再拼一个 /v1,变成 …/v1/v1/… 导致连接失败。或者也可以填 https://api.apimodels.app 让它自己补 /v1。

常用模型 ID

完整列表会出现在 Cherry Studio 的模型下拉里(我们的 /v1/models 端点),常用的有:

用途模型 ID
聊天 / 编码gpt-5.6-sol · gpt-5.6-terra · gpt-5.6-luna-max · gpt-6.1-sol · claude-opus-5-5 · gemini-3-pro-preview · glm-5.2 · deepseek-v4-flash
文生图 / 改图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://api.apimodels.app/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: ![a cute corgi puppy on grass](https://r2.apimodels.app/images/….png)

在同一条消息里附带一张图,就是图生图 / 改图 —— 描述你要改什么即可。注意:每条消息独立成图,上一轮的图不会被自动当作参考,所以「画只猫」之后再「画只狗」不会串味;要基于上一张改,请把那张图重新附上。

出图通常 10–90 秒,取决于模型和分辨率;流式模式下连接会一直保活,不是卡死。失败不计费。

需要程序化调用(自己控制尺寸、张数、回调)时,标准的 OpenAI 图片接口仍然可用:

curl -s https://api.apimodels.app/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 秒自检

连不上时,先用 curl 确认 key 和端点本身没问题(这正是 Cherry Studio 检查连接时打的 /models):

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

再测一条聊天:

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

排错

症状原因 / 修法
检查连接失败 / 拉不到模型API 地址结尾没带斜杠,被拼成了 …/v1/v1/…。改成 https://api.apimodels.app/v1/(带 /)。
HTTP 401key 错了或被禁用。去控制台新建一个 sk_… 重填。
模型选了没反应 / 400 Unknown model模型 ID 拼错。用横杠形式,如 gpt-6.1-sol、gpt-image-2(见上表)。
画图很久才出 / 看似卡住出图本身要 10–90 秒,我们会一直等到图片生成完再返回(流式下持续保活),属正常,不是卡死。
API 地址填了完整端点 → 404Cherry Studio 会在你填的地址后面继续拼路径。填 …/api/v1/images/generations 会变成 …/images/generations/chat/completions(不存在)。只填到 https://api.apimodels.app/v1/。地址框下方的「预览」那行就是最终 URL,配完先看一眼。
「没有可以被检测的模型(例如对话模型)」模型列表还是空的(模型 0),先用 + 添加一个模型再检测。这个提示不代表 key 或地址有问题。另外注意:选中图片模型点检测,会真的生成一张图并计费,用聊天模型检测更省。
「AI 绘画 / 图像」模块里选不到我们这是 Cherry Studio 自身的限制:自定义服务商的图片模型进不了绘画模块(官方 issue 已标记 not planned)。改在普通对话里选图片模型即可,效果一样。
相关:/docs/llm/docs/image控制台 → API Keys