Cherry Studio 接入 kkaiapi
最后更新:
配置 Cherry Studio 的 OpenAI 兼容聊天连接,再独立核对 GPT Image 绘画入口与图片接口,提供完整教程和编辑路径。
先配置聊天服务商,再配置绘画入口
在 Cherry Studio 设置的模型服务中添加 OpenAI 兼容服务商,设置 Key、API 地址和聊天模型,启用后选择该模型。图片生成需客户端另有绘画入口并调用 images/generations,不能把图片模型作为聊天模型测试。
| 配置项 | 值 |
|---|---|
| 服务商协议 | OpenAI-compatible |
| API 地址 | https://api.kkaiapi.com/v1 |
| API Key | 自己的 KK Key |
| 聊天模型 | claude-sonnet-5-5 |
| 绘画模型(绘画入口) | gpt-image-2 |
保存后验证一次聊天请求
配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "请只回复 pong"}],
)
print(r.choices[0].message.content)核对实际生效的工具路径
先验证聊天,再进入当前版本的绘画功能核对请求路径。若该入口不能选择模型或分辨率,使用图片接口文档调用,不伪造客户端字段。已有图片编辑另走 multipart /v1/images/edits。
配置依据与能力验证
配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。
配置字段依据cherry-studio 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。
常见问题
为什么 API 请求成功,工具仍不能完成任务?
继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。