如何将 WebP 图像转换为 JPEG 格式

先确认输入形式与转换目标

WebP 转 JPEG 的关键在于准备正确的图像数据格式，而不是输入文件名。这个工具接收的是经过 Base64 编码的 WebP 图像数据，适合需要把一种图像格式交给 JPEG 后续流程的场景。转换完成后，返回内容仍然是经过 Base64 编码的数据，代表生成的 JPEG 字节。

输入值为空时不会进行图像转换，因此开始操作前应先准备可解码的 WebP 数据。质量参数可以按需要填写；如果留空，保存 JPEG 时会采用默认值 90。对于带有 RGBA 或调色板模式的图像，保存前会先转换为 RGB，以适应 JPEG 的保存过程。

提交数据并设置 JPEG 质量

1. 准备一张 WebP 图像，并取得它对应的 Base64 编码字符串。输入框应填写这段编码后的图像数据；文件名、文件路径或图片网址不能替代需要解码的 Base64 内容。

2. 将 Base64 字符串填入图像数据输入框。这个输入虽然可以省略，但省略后得到的是空值，而空值会使操作失败，所以实际转换时应提供内容可用的字符串。

3. 根据后续用途决定是否填写质量参数。留空时使用默认值 90；如果手动输入数值，现有说明只确认该值会传给 JPEG 保存操作，并没有确认可用范围、舍入方式或超出范围后的处理方式。

4. 提交转换请求。RGBA 图像和调色板图像会在保存为 JPEG 之前转换成 RGB，其他图像也需要先成功完成 Base64 解码并被识别为可处理的图像。

5. 读取返回内容并交给后续环节。转换成功时，返回的是 JPEG 字节的 Base64 编码；如果操作报告失败，请重新检查编码内容、图像数据以及所填写的参数，再进行处理。

判断返回内容并处理失败

成功返回的内容不是原始二进制，也不是可以直接当作文件名使用的文本，而是对 JPEG 字节进行 Base64 编码后的结果。需要保存或继续传递时，应按照后续环节所需的方式处理这段编码内容，并由能够接收该格式的流程使用它。

出现失败时，先区分输入问题和处理问题。空的图像数据会在转换前导致失败；Base64 解码异常、图像处理异常，或所需的图像处理依赖不可用时，操作同样会报告失败。失败结果不能被当作已经生成的 JPEG 使用。若没有填写质量参数，默认值仍为 90，但这并不代表其他质量数值的行为已经被规定。

透明图像或调色板图像在转为 RGB 后保存为 JPEG，因此后续环节应以 JPEG 返回数据为准，而不要期待保留原始图像模式。检查结果时，重点是确认返回内容对应 Base64 编码的 JPEG 数据，并确认下游处理能够识别这种表示形式。

使用示例

你需要把一张 WebP 图像交给只接收 JPEG 数据的后续处理环节。

将一张已编码为 Base64 的 WebP 图像数据提交转换，并保留质量参数为空；成功后检查返回内容是否为 Base64 编码的 JPEG 数据。

成功时，返回一段代表 JPEG 字节的 Base64 编码内容。

使用限制

• 已确认的行为没有规定质量参数的可用范围、舍入方式或超出范围后的处理；解码异常、图像处理异常或所需图像处理依赖不可用时，操作会报告失败。

常见错误

• 输入了空值、文件名或不能正常解码的字符串会导致处理失败；请改为提供有效的 WebP 图像 Base64 数据，并在提交前确认编码内容没有被截断。

常见问题

可以不填写图像数据吗？

由于空的图像数据会使操作失败，因此不能省略实际内容；请先准备能够解码为 WebP 图像的 Base64 字符串，再提交转换。

可以直接输入本地文件路径或图片网址吗？

由于输入会先按 Base64 解码再尝试打开所得字节，文件名、文件路径或图片网址并不是这里需要提交的图像数据；请使用编码后的 WebP 内容。

不设置 JPEG 质量时会使用什么值？

如果不填写质量参数，JPEG 保存操作会采用默认值 90；手动设置时，现有说明没有规定数值范围、舍入方式或超出范围后的行为。