如何对图像应用艺术滤镜和效果

提供有效的图片数据，选择支持的滤镜名称后提交即可；省略滤镜时会使用 emboss。成功结果会返回处理后的 Base64 图片数据、所选滤镜名称和图片尺寸。

先了解输入与用途

这款工具用于把一张图片转换为带有艺术效果的版本。它接收图片数据，并可选择一种内置滤镜；如果不指定滤镜，默认使用浮雕效果。适合在需要快速尝试柔化、锐化、边缘处理或浮雕风格时使用。

操作步骤：上传图片并应用滤镜

1. 准备一份有效的图片数据，并将其作为图片输入提供。图片数据会先按 Base64 解码，再尝试打开为图片，因此不能直接提交任意文字作为图片。
2. 选择一个滤镜名称。可选名称包括 blur、contour、detail、edge_enhance、edge_enhance_more、emboss、find_edges、sharpen、smooth 和 smooth_more。如果省略滤镜名称，将使用 emboss。
3. 提交处理请求并等待结果。处理成功后，取出返回的 Base64 编码图片数据；同时查看返回的滤镜名称和图片尺寸，确认实际采用的效果与输入尺寸。
4. 将返回的图片数据解码后保存或用于后续处理。若需要保留特定图片格式，应检查输出结果，因为保存格式取决于处理后的图片格式；无法确定时会使用 PNG。

如何判断结果

成功结果应包含三类信息：经过滤镜处理的 Base64 图片数据、所选滤镜名称，以及图片尺寸。返回数据可用于生成处理后的图片，但返回成功并不代表视觉效果一定符合预期，建议根据原图和用途检查结果。

如果输入图片缺失或为空、滤镜名称无法识别，或图片在解码、打开、处理、保存任一环节发生异常，结果会失败。特别是对非 RGB 图片使用 emboss 时，图片会先转换为 RGB，这可能移除原有格式元数据，并使输出回退为 PNG。

使用示例

你有一张需要制作浮雕效果的产品图片，因此提供其有效图片数据并选择 emboss 进行处理。

准备一张有效的 RGB 图片数据，选择 emboss 后提交处理，再解码返回的 Base64 数据并检查结果中的滤镜名称和图片尺寸。

结果应包含经过 emboss 处理的 Base64 图片数据、emboss 这一所选滤镜名称，以及输入图片的宽度和高度等尺寸信息。

使用限制

• 处理能否成功取决于图片是否可解码和打开、滤镜名称是否受支持以及后续处理和保存是否正常；输出格式也可能因处理后的图片格式而变化。

常见错误

• 如果结果失败，先检查图片数据是否确实存在且不为空，并确认它是可解码的 Base64 图片数据；不要把文件名、路径或普通文字直接当作图片数据提交。

常见问题

没有指定滤镜时可以处理图片吗？

可以，但图片数据不能缺失或为空，并且需要能够被 Base64 解码后打开为图片。

支持哪些滤镜名称？

可以选择 blur、contour、detail、edge_enhance、edge_enhance_more、emboss、find_edges、sharpen、smooth 或 smooth_more。使用其他名称会导致处理失败。

处理后的图片会保存为什么格式？

这取决于处理后的图片格式；如果无法确定可用格式，输出会使用 PNG。对非 RGB 图片使用 emboss 时，转换为 RGB 可能移除原格式元数据并触发 PNG 回退。