您在此处：
图像转换 URL 结构、验证和操作顺序
图片转换请求使用 /dw/image/v2/ 路径和查询字符串。B2C Commerce Dynamic Imaging Service 按固定顺序应用这些参数。
有关转换类型、参数名称、JavaScript 转换对象和验证详细信息，请使用 “支持的转换” 表。本主题仅介绍路径形状、操作顺序以及输出格式与 URL 的关系。
路径标记
转换后的图片 URL 使用路径段 /dw/image/v2/ 和通常的静态内容路径（例如， on/demandware.static/...）。使用 Dynamic Imaging Service 中的 URLUtils 和 MediaFile 类生成 URL，如在中心 相关 Dynamic Imaging Service 主题 中。
输出格式和文件扩展名
生成的 URL 中的文件扩展名（例如， . webp 或 . avif ）选择输出格式。需要时， sfrm 参数可以指定源图像格式。请参阅 支持的转换 中的“格式”行。
操作顺序
当多个转换类型应用于单个请求时，Dynamic Imaging Service 将按以下顺序处理它们。如果合并裁剪和缩放，请在 原始 源图像上规划裁剪，因为服务会先应用裁剪，然后再缩放结果，而不是相反。
- 格式（指定时）
- 背景颜色 （
bgcolor），用于在使用时展平透明度 - 裁剪 （
cx，cy，cw，ch） - 调整大小/缩放模式（
sw、sh、sm） - 叠加层 （
ox，oy，oimg） - 质量 （
q） - 元数据条（
条带）
参数验证规则（快速参考）
该服务拒绝参数无效的请求，并返回 400 错误请求。有关完整规则，请参阅 支持的转换 表。
| 参数 | 规则 | 必填 |
|---|---|---|
SW、 SH
|
整数，10 到 3000 像素。如果存在，则不能为空。 | 否 |
Sm
|
剪裁 （默认）或 适合。仅与 sw 和 sh 一起使用。
|
否 |
CX、 CY
|
整数，0 或更大。同时需要所有四个作物参数。 | 有作物 |
连续波、 通道
|
整数，10 或更大。同时需要所有四个作物参数。 | 有作物 |
牛， 哎呀
|
整数，0 或更大。同时需要所有三个叠加参数。 | 带叠加 |
OIMG公司
|
Dynamic Imaging Service 域上客户拥有的映像的 URL 编码路径。最多 400 个字符。支持的格式：GIF、PNG、JPG、JP2。 | 带叠加 |
BG颜色
|
6 位十六进制（不透明）或 8 位十六进制（仅限 alpha、PNG 输出）。 | 否 |
问
|
整数，1 到 100。JPG/JP2 默认为 80。使用默认值时省略。 | 否 |
SFRM
|
源格式： gif、 jp2、 jpg、 jpeg、 png、 tiff 或 tif。
|
否 |
带
|
true （默认值）去除元数据; false 保留它。 |
否 |
400 响应的常见原因
- 同一 URL 中的重复参数 （
？sw=100&， sw=200）。最后一个值优先，这可以掩盖逻辑错误。 - 空值 （
？sw=&sh=400）。 - 错误的分隔符，通常是杂散
的 %而不是&。 - 覆盖 URL 中的未编码空格或其他保留字符。
- 裁剪或叠加参数集不完整。
- 超出上述范围的值（例如，
sw=5）。
有关文件大小、超时、图像准则和动态图像缓存，请参阅 Dynamic Imaging Service 。对于 故障排除和迁移 ，请使用该主题。
本文章是否解决您的问题？
请与我们共享您的想法，以便我们进行改进！
