跳到主要内容

在 Cherry Studio 中使用image2

  1. 参照 创建令牌分组 一章的教程,创建令牌分组为 GPT-Image2 的令牌。创建好令牌后,点击复制按钮,将 API Key 复制到剪切板。
  2. 访问 Cherry Studio 官网下载并安装软件。
  3. 打开 Cherry Studio,点击左下角设置按钮,进入 模型服务 页面,点击底部的 添加 按钮新增提供商。
  4. 在添加提供商窗口中填写提供商名称,例如 constreet-gpt-image2提供商类型 选择 New API,然后点击 确定

  1. 在左侧列表中找到刚添加的提供商,将第 1 步复制的 sora 分组 API Key 填入 API 密钥API 地址 填写 https://api.constreet.cc

  1. 点击模型区域右侧的 获取模型列表,刷新后添加 gpt-image-2 模型。添加完成后,可以在提供商配置页中看到模型列表里已经出现 gpt-image-2
  2. 点击 gpt-image-2 右侧的编辑按钮,进入编辑模型窗口,将 端点类型 设置为 图像生成(OpenAI),然后点击 保存

  1. 回到首页,点击顶部的 + 按钮,在应用列表中选择 绘画

  1. 进入绘画页面后,左侧 提供商 选择刚才添加的供应商,模型 选择 gpt-image-2。首次使用建议先将 图片尺寸质量敏感度 等选项保持为 自动生成数量 保持为 1

  1. 如果只需要根据提示词生成图片,顶部选择 绘图 模式,输入提示词后点击发送按钮即可开始生成。
  2. 如果需要上传参考图进行图生图或局部修改,顶部切换到 编辑 模式,在左侧 输入图片 中上传参考图,再输入修改要求后点击发送按钮。

使用建议

  • API 地址 直接填写 https://api.constreet.cc 即可,Cherry Studio 会自动拼接兼容端点,无需手动补 /v1
  • 如果模型列表中没有 gpt-image-2,请先在 管理 中刷新模型;如果仍无法正常绘图,请检查 端点类型 是否为 图像生成(OpenAI)
  • 使用 绘图 模式可以进行文生图;使用 编辑 模式可以上传参考图进行图生图或局部修改。
  • 如果你在普通对话页中直接调用 gpt-image-2,建议关闭 流式输出,避免返回内容解析异常。使用 绘画 应用时通常不需要额外处理。

可能出现的问题

如果 Cherry Studio 弹出 Failed to fetch,通常是请求连接被中断,可能与本机代理或网络环境有关。可以先检查代理设置,确认 Cherry Studio 能正常访问 https://api.constreet.cc 后再重试。

如果 Cherry Studio 弹出 Unexpected token '<', "<html><h"... is not valid JSON,通常是请求过程中收到了 Cloudflare 等页面内容,客户端按 JSON 解析时显示异常。遇到这种情况可以直接重试,或稍后再重新生成。

特别注意:长连接与代理设置

无论是直接通过 API 调用,还是在 Cherry Studio 等客户端程序中使用 gpt-image-2,图片生成请求通常都比普通聊天请求耗时更久,尤其是使用编辑模式、高清质量或高分辨率尺寸时。如果本机代理、网络工具或中间网关对长连接有限制,可能会在 60 秒左右主动断开连接,表现为 API 请求超时、没有返回内容,或客户端提示 Failed to fetch

下面以 Cherry Studio 的编辑模式为例,长连接中断时程序侧通常会直接弹出 Failed to fetch;在开发者工具中,也可以看到 edits 请求停在 1 分钟左右。直接调用 API 时虽然界面提示不同,但问题本质相同,都是连接在图片生成完成前被中途断开。

如果确认是代理导致连接被中断,建议将本站域名 constreet.cc 加入代理工具的直连或白名单规则,让访问 Constreet API 时不再经过代理。不同代理软件的设置入口可能不同,核心是添加类似 domain:constreet.cc 的域名规则。

放行后,同类请求可以等待更久并正常返回。请求在约 1.6 分钟后返回图片;如果使用更高分辨率或更高质量选项,生成时间还可能继续增加。为了减少不可控的网络中断,建议绘图请求尽量直连 constreet.cc,不要经过会限制长连接的代理或中转网络。