Photoroom API 同样设 20% 留白，横图和竖图为什么不一样？

先用输出画布的宽高计算，而不是商品本身的尺寸。Photoroom API Positioning 官方文档说明，百分比留白以输出边长为基准。因此，横版和竖版即使都写“20%”，对应的像素距离也可能不同。这里讨论 API 定位，不是手机或网页应用里某个同名按钮的规则。

关键要点

• 左右百分比对应输出宽度，上下百分比对应输出高度。
• 先核实际输出尺寸和各边设置，再比较可见留白。
• 原图已裁断的商品边有 padding 例外，不能只靠放大百分比排查。

先把计算基准写在同一张记录里

记录原图、目标输出宽高、本次请求各边的留白要求，以及实际得到的文件。不要只保留一句“用了统一留白”：改了输出比例，计算基准就可能改变；只改了一条边，也不能当作四边都相同。

如果交付要求是“左右实际各留同样宽的空隙”，应先将该要求交给接口制作人员按当前文档转换为适合输出尺寸的设置。不能把“百分比一致”和“像素距离一致”当成同一个目标，也不要把本文的文字百分比直接当作可以复制的请求编码。

虚构计算：横竖画布调换宽高

以下是虚构的算术练习，未调用 API；尺寸只为解释基准，不是平台推荐规格。设横版输出为1200×800，竖版为800×1200，假设四边都要求20%的留白。

相同百分比在这里没有给出相同的四周像素距离。表格只解释留白设置的基准，不保证商品会被拉伸成剩余矩形，也不提供一次请求的实际测量结果。商品比例、裁切情况和其他定位设置仍需结合真实输入检查。

先在两份实际输出上分别核尺寸，再观察主体与四边的关系。若尺寸都不是请求目标，先查输出与请求的对应关系；若尺寸正确而视觉位置仍不同，再继续查各边设置和源图裁断情况，不要马上归因于随机生成。

为什么某一边加了 padding 仍贴边？

同一官方文档给出另一项条件：主体在原图边缘被裁断时，该裁断边默认不会加入 padding；需要该处距离时可以评估 margin。此时问题已不是20%算错，而是输入边界触发了不同处理。

先查看原片，而不只看已经抠好的缩略图。商品是否在某边截断、是否本来就缺少完整轮廓，应与实际请求一并记录。确认是文档所述的裁断边后，再由接口制作人员按当前参数说明配置 margin 并核对输出。本文没有提供未核验的字段组合、单位或默认值。

加出外边距也不会找回原片没有拍到的壶嘴、手柄或鞋尖。若交付必须展示完整商品，应补拍完整参考；不能用扩大画布后的合理形状证明商品确实如此。

把最终结论分成计算与画面两项

计算检查回答“输出尺寸及基准是否符合请求”；画面检查回答“商品有没有完整展示，实际留白是否适合本次布局”。两项都明确后才交给后续海报或商店制作人员。无法确定原图是否裁断，或无法对应本次请求与输出时，保持待核，不继续批量覆盖。

一般批量图的视觉复核可接着看主体比例与四边留白检查，但不要把 Web App 操作当成 API 参数。背景只是要统一底色时，参考静态背景流程；需要生成新边缘时，另做新增商品部件审核。

本文由 Itemlume 编辑团队采用 AI 辅助编辑，依据截至2026年10月29日核对的官方文档整理，未调用接口或测量实际输出。了解编辑主体或联系勘误。