RGBA image support in `gr.ImageEditor()`

问题场景

用户在 Gradio 中搭建图像编辑流程，使用 gr.ImageEditor() 作为输入组件，读取带透明背景的 PNG（例如示例中的 fruit.png），再通过输出组件取出编辑后的背景图。期望编辑过程中保留原图的透明度，但实际得到的图片透明区域丢失。

报错原文

RGBA image support in `gr.ImageEditor()`

The `gr.ImageEditor()` component does not support RGBA images with transparency. It forcibly converts them to RGB images by dropping the alpha channel.

原因分析

gr.ImageEditor() 组件在处理输入图像时会将 RGBA 图像强制转换为 RGB，直接丢弃 alpha 通道，因此透明度信息在进入编辑器前就已丢失。Issue 的结论认为这属于组件能力缺失（enhancement）而非使用方式问题，最终通过代码修复加入 RGBA 支持。

环境排查

• 确认 Gradio 版本：Issue 复现版本为 5.38.0，该版本不支持 RGBA。
• 确认 Python 版本：Issue 使用 Python 3.13.5。
• 确认输入图片格式：是否为带 alpha 通道的 PNG（RGBA），可用图像工具查看通道信息。
• 确认是否已升级到包含 #13874 / #13937 的 Gradio 版本（7.0-dev 或后续 6.x）。

解决步骤

1. 记录当前 Gradio 版本，确认是否低于已修复版本（Issue 复现版本 5.38.0 属于受影响范围）。
2. 将 Gradio 升级到包含该修复的版本：修复已合入 7.0-dev，并回移到 6.x（#13937），会在下一个 6.x 版本发布。
3. 升级后重新运行 Issue 中的最小复现脚本，使用带透明背景的 fruit.png 作为 gr.ImageEditor() 的输入。
4. 若仍无法升级，可临时在进入 gr.ImageEditor() 之前对图像做预处理/后处理，自行保留 alpha 通道，但这不是 Issue 中验证过的官方方案，属于可优先尝试的绕行思路。

验证方法

用带透明背景的 PNG 运行 Issue 中的示例脚本，检查 gr.ImageEditor() 编辑后经输出组件返回的图像是否仍保留透明区域（alpha 通道未被丢弃）。若透明度正常呈现，说明问题已解决。

参考来源

gradio-app/gradio #11628

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。