分类: Cherry Studio 教程

Cherry Studio 接入 DeepAI API 中转站、OpenAI 兼容接口和多模型配置教程。

Cherry studio deepai mcp function calling model.png

Cherry Studio 接入 DeepAI API 中转站:MCP 不显示或不调用的 function calling 排查Cherry Studio 接入 DeepAI API 中转站:MCP 不显示或不调用的 function calling 排查

Cherry Studio 配好 MCP Server 后工具按钮不显示、MCP 没被调用,常见原因是输入框未启用 MCP,或模型没有被识别为 function calling 模型。本文结合 Cherry Studio Issue #3513 和 MCP 文档,整理 DeepAI API 中转站接入时的模型能力、tools 透传与日志排查方法。

Cherry studio deepai gpt5 reasoning effort 400.png

Cherry Studio 接入 DeepAI API 中转站:GPT-5 reasoning.effort 400 怎么排查Cherry Studio 接入 DeepAI API 中转站:GPT-5 reasoning.effort 400 怎么排查

Cherry Studio 通过 OpenAI-compatible Provider 接入 GPT-5 系列模型时,reasoning effort 需要按模型能力传参:gpt-5/gpt-5-mini/gpt-5-nano 支持 minimal/low/medium/high,但 gpt-5-chat-latest 可能不支持 reasoning.effort。本文结合 Cherry Studio Issue #9013 和 PR #8945,整理 DeepAI API 中转站场景下的排查与配置方法。

Cherry studio deepai gpt image 2 response format error.png

Cherry Studio 接入 DeepAI API 中转站:gpt-image-2 报 Unknown parameter response_format 怎么修Cherry Studio 接入 DeepAI API 中转站:gpt-image-2 报 Unknown parameter response_format 怎么修

Cherry Studio 使用 OpenAI-compatible Provider 调用 gpt-image-2、gpt-image-1.5 等图像模型时,如果返回 400 Unknown parameter: response_format,通常不是 Key 或 Base URL 错,而是客户端给新图像模型多传了 response_format。本文结合 Cherry Studio Issue #14485 和 PR #14578,整理 DeepAI API 中转站场景下的排查和修复方法。

Cherry studio deepai pdf file data base64.png

Cherry Studio 接入 DeepAI API 中转站:PDF file_data 的 Data URL 前缀与 Base64 解码排查Cherry Studio 接入 DeepAI API 中转站:PDF file_data 的 Data URL 前缀与 Base64 解码排查

Cherry Studio 通过 OpenAI-compatible API 上传 PDF 后文件损坏怎么办?本文结合 Cherry Studio GitHub 已关闭 Issue,说明 Data URL 前缀、纯 Base64、file_data 解码、SHA256 校验和 DeepAI API 中转站文件处理最佳实践。

Cherry studio deepai v1 messages 404 fixed.png

Cherry Studio 接入 DeepAI API 中转站:/v1/messages 404 与 Base URL 避坑指南Cherry Studio 接入 DeepAI API 中转站:/v1/messages 404 与 Base URL 避坑指南

Cherry Studio 使用 OpenAI-compatible 或 Anthropic Messages 接口时,/v1/messages 被拼成 /v1/v1/messages 会导致 404。本文结合 GitHub 已关闭 Issue,整理 DeepAI API 中转站的 Base URL 配置、排查顺序和客户端接入建议。