如何转换图像格式

开始前确认数据与格式

图像格式转换用于把已提供的图像数据编码成另一种格式。工具支持 PNG、JPEG、WEBP、GIF、BMP 和 TIFF；目标格式不填写时，默认选择 PNG。输入并不是图像文件名，而是按 base64 编码的图像字节，因此开始前应准备好对应内容。

这项操作适合已经取得图像数据、需要指定输出格式并希望检查转换结果的场景。目标格式可以使用大小写不同的写法，JPG 会按 JPEG 处理。质量参数并非对每种输出格式都以同样方式应用，所以选择格式后，还要按照目标编码器的行为理解结果。

按顺序完成格式转换

1. 准备图像数据。将图像内容按 base64 编码为图像字节，并把它作为图像数据提供。虽然该输入项本身可以不填，但没有图像数据时不会执行转换，而是返回失败结果。

2. 选择目标格式。可填写 PNG、JPEG、WEBP、GIF、BMP 或 TIFF；格式名称不区分大小写，使用 JPG 时会按 JPEG 处理。若省略目标格式，输出会采用 PNG。

3. 仅在目标为 JPEG 或 WEBP 时考虑质量参数。未提供质量值时，默认值为 90；这个值会传给 JPEG 或 WEBP 编码器，但不会传给 PNG、GIF、BMP 或 TIFF 编码器。已知的行为是参数传递方式，不代表不同格式会呈现相同的质量效果。

4. 提交转换并读取返回结果。成功时，返回内容包括编码后的转换图像数据、选定的输出格式以及输出字节数。若目标格式超出支持范围，操作会失败；图像解码、打开、转换或保存阶段出现问题时，也会返回未成功的结果。

5. 根据失败原因排查输入和环境。先确认图像数据确实已提供，并且内容能够被解码，再核对目标格式拼写。若失败结果表明 Pillow 未安装，说明当前处理所需的 Pillow 不可用，继续修改质量值不会解决这一前置问题。

读取成功状态与失败边界

成功结果中的图像数据是转换后的编码内容，输出格式用于确认实际采用的目标格式，输出字节数用于了解该结果的大小。三项信息应结合查看，而不能只凭目标格式字段推断图像数据已经成功生成。

当目标是 JPEG，而原图处于 RGBA 或调色板模式时，处理会先把图像转换为 RGB，再保存为 JPEG。这是该类输入的转换路径；它不表示 PNG、GIF、BMP 或 TIFF 也会采用同一处理方式。

如果返回未成功，缺少输入、目标格式不受支持、图像处理阶段出错以及 Pillow 不可用都可能对应不同的排查方向。质量值只参与 JPEG 和 WEBP 的编码调用，因此为其他格式填写该值时，不能把它理解为会传入相应编码器。

使用示例

用户把一份已准备好的图像数据转换为 WEBP，并核对返回内容中的数据、格式和大小信息。

准备一份图像的 base64 编码数据，将其作为图像数据提供，选择 WEBP 作为目标格式并提交转换。

成功返回应包含转换后的图像数据、实际选定的输出格式以及输出字节数。

使用限制

• 目标格式仅限 PNG、JPEG、WEBP、GIF、BMP、TIFF 及 JPG 别名；质量参数的编码器传递行为只适用于 JPEG 和 WEBP，未说明其他格式的质量变化规则。

常见错误

• 只填写目标格式而遗漏图像数据会导致转换失败；请补充按 base64 编码的图像字节后重新提交。

常见问题

目标格式可以填写 JPG 吗？

填写 JPG 时，目标会按 JPEG 处理；此外还可选择 PNG、WEBP、GIF、BMP 或 TIFF，格式名称的大小写不影响识别。

省略质量值后会采用什么设置？

未提供质量值时，编码调用采用默认值 90；该参数只传给 JPEG 和 WEBP，不传给 PNG、GIF、BMP 或 TIFF。

不提供图像数据可以直接转换吗？

没有图像数据时，操作会返回失败，而不会仅凭目标格式生成转换结果；需要先提供按 base64 编码的图像字节。