Cherry Studio 通过 DeepAI API 中转站 接入 OpenAI-compatible Provider 时，聊天模型能正常回复，不代表图像生成模型也会无缝工作。图像接口的请求体、返回格式、multipart 上传和客户端占位符状态都更敏感。一个很典型的问题是：调用 gpt-image-2 时返回 400 Unknown parameter: response_format。
response_format。问题背景：gpt-image-2 返回 Unknown parameter response_format
这个问题来自 Cherry Studio Issue #14485。用户在 Windows 版 Cherry Studio v1.92 中调用 gpt-image-2，界面提示 Unknown parameter: 'response_format'，图片生成图标也无法取消。后续 PR #14578 合并修复，明确覆盖了 gpt-image-2、gpt-image-1.5、gpt-image-1*、chatgpt-image-* 等模型在 OpenAI-compatible Provider 下的失败场景。
从 DeepAI API 中转站的角度看，这类报错很容易被误判。因为请求确实打到了网关，状态码也是模型服务返回的 400，看起来像是网关不兼容。但错误字段已经说明：请求体里包含目标图像模型不接受的参数。
根因：OpenAI-compatible Image Model 自动追加了 response_format
旧的图像生成链路里，客户端常常会在 /v1/images/generations 请求体里加入 response_format: "b64_json"。但新一代图像模型并不都接受这个参数。PR #14578 的说明里提到，之前 Cherry Studio 的 OpenAICompatibleImageModel.doGenerate 会无条件添加 response_format: "b64_json"，导致 OpenAI-compatible 类型的 provider，以及 AiHubMix、NewAPI、CherryIN 等网关图像模型继续报 400。
错误请求大致类似：
{
"model": "gpt-image-2",
"prompt": "生成一张产品封面图",
"size": "1024x1024",
"response_format": "b64_json"
}
修复后的思路是：当模型 ID 以 chatgpt-image-、gpt-image-1-mini、gpt-image-1.5、gpt-image-1、gpt-image-2 等前缀开头时，不再默认追加 response_format。也就是说，客户端要让模型服务自己按新接口规范返回结果。
DeepAI API 中转站用户怎么排查
- 确认 Cherry Studio 的 Provider 类型是 OpenAI Compatible，Base URL 写到
https://api.deepai.wang/v1，不要写到具体接口路径。 - 确认模型 ID 与 DeepAI API 中转站后台支持的图像模型一致，例如
gpt-image-2。 - 查看中转站请求日志，如果日志里有
/v1/images/generations且返回 400，再看错误字段是否为response_format。 - 升级 Cherry Studio 到包含 PR #14578 修复的版本，或确认当前客户端没有对这些新图像模型追加
response_format。 - 再次用短 prompt 生成一张测试图，确认返回 200、图片能渲染、生成占位符能正常消失。
如果你维护的是自定义客户端或脚本，也可以直接对比请求体。调用 gpt-image-2 时，先移除 response_format，保留 model、prompt、size、n 等必要字段，再测试 DeepAI API 中转站是否正常返回。
不要把这个问题和 Base URL 404 混在一起
Unknown parameter: response_format 与常见 Base URL 错误不是一类问题。Base URL 写错通常表现为 404、请求没有进入正确接口、或中转站后台没有日志。response_format 报错则说明请求已经到达图像生成接口，但请求体字段不被目标模型接受。
- 后台无日志：先检查 Base URL、代理、网络和客户端是否仍在使用旧配置。
- 404：检查是否把 Base URL 写成了
/v1/images/generations，导致客户端重复拼接路径。 - 401：检查 DeepAI API Key、额度、过期时间和权限。
- 400 response_format：检查客户端版本和图像请求体字段。
PR #14578 还修了哪些图像生成坑位
这次 Cherry Studio 修复并不只处理 response_format。PR #14578 还提到几个在 OpenAI-compatible 图像链路里很常见的坑：
- multipart Content-Type：图片编辑接口使用 form-data 时，不应在 auth headers 里强行写死
Content-Type: application/json，否则服务端会按 JSON 解析 multipart 边界。 - mimetype 错误：上传图片时不能只传
image这种文件类型枚举，应使用真正的 MIME 类型，例如image/png或image/jpeg。 - 文件扩展名拼接：历史保存记录可能存在扩展名前面有没有点的不一致，读取文件时应使用真实文件名。
- 占位符不消失：图片生成成功后，需要正确发出完成事件，否则界面会留下一个持续加载的 placeholder。
这些问题说明，图像模型接入比文本模型更依赖客户端实现细节。DeepAI API 中转站可以统一网关、鉴权、路由和日志，但客户端仍然需要按目标模型接口规范构造请求。
适合站长的上线验证清单
- 在 Cherry Studio 中新建一个独立的 DeepAI API 中转站 Provider，避免和其他网关配置混用。
- 先测试普通聊天模型，再测试图像生成模型，不要用一个成功结果覆盖另一个链路。
- 生成图片时先用短 prompt、单张图、常见尺寸，减少排查变量。
- 在 DeepAI API 中转站后台确认请求路径、状态码、耗时和模型路由。
- 将客户端版本、模型 ID、请求时间和错误字段记录下来，方便后续定位是客户端、网关还是模型服务问题。
为什么这类文章对 API 中转站 SEO 有价值
很多用户搜索“Cherry Studio gpt-image-2 response_format”“OpenAI Compatible 图片生成 400”“API 中转站图片模型报错”时，真正需要的不是泛泛的模型介绍，而是可复现的排查路径。把 GitHub 已解决 Issue 转化成接入教程，可以让用户理解：DeepAI API 中转站负责提供统一 OpenAI-compatible 入口，而客户端请求体、模型版本和图像接口规范也要匹配。
当用户按文章完成排查后，如果后台日志清晰、状态码明确、错误字段能对应到客户端修复点，就会更容易信任中转站能力。这比单纯堆“低价、稳定、支持多模型”关键词更适合长期 SEO。
参考资料
- Cherry Studio Issue #14485：调用 gpt-image-2 提示 Unknown parameter response_format
- Cherry Studio PR #14578：修复 gpt-image-2 / gpt-image-1.5 图像生成失败和 pending placeholder
- Cherry Studio 接入 DeepAI API 中转站：PDF 文件 Data URL 排查
- DeepAI API 中转站教程导航
总结
Cherry Studio 接入 DeepAI API 中转站调用 gpt-image-2 时，如果遇到 Unknown parameter: response_format，优先检查客户端版本和图像请求体，不要先怀疑 API Key 或 Base URL。升级到包含 PR #14578 修复的版本，或在自定义客户端中移除对新图像模型不支持的 response_format 参数，再结合 DeepAI API 中转站日志验证请求路径和状态码，通常就能快速恢复图片生成。
