| aspect_ratio | 目标宽高比。可选值：original（保持原图）、custom（自定义）、常见比例如 1:1、16:9、9:16 等。 |
| proportional_width | 当 aspect_ratio = custom 时，设置宽的比例值。仅在使用自定义比例时有效。例如输入 3 和 2 表示比例为 3:2。 |
| proportional_height | 当 aspect_ratio = custom 时，设置高的比例值。配合 proportional_width 使用，建议避免设为 0。 |
| fit | 图像适配方式，可选：letterbox（等比+留边）、crop（裁切填满）、fill（强制拉伸填满）。推荐使用 letterbox 保留原比例，或 crop 用于头像、特写图。 |
| method | 缩放插值方法。
lanczos（兰索斯插值）：高质量缩放算法，边缘保留效果好，不过耗时稍高，推荐作为默认选择，适用于高清图像。
bicubic（双三次插值）：插值效果平滑自然，运算速度较快，质量比 lanczos 稍逊，适合对一般图像进行缩放。
bilinear（双线性插值）：计算速度快但效果较为粗糙，适用于图像预览以及轻量处理的场景。
box（方框平均插值）：采用简单平均的方式，主要用于降采样，速度快但质量一般。
hamming（汉明插值）：与 lanczos 类似，质量略低，边缘保留效果较好，适用于对边缘保持有一定要求的图像。
nearest（最近邻插值）：保留像素块，不进行平滑处理，适合像素风格图、遮罩图、分割图，不推荐用于真实图像的缩放。 |
| round_to_multiple | 将最终宽高对齐为某个倍数（如 64、128），或选 None 不做对齐。 |
| scale_to_longest_side | 是否将图像最长边缩放为固定值（如 1024），另一边按比例自动调整。开启后可控制输出最大边长度，适合保证输出不超过 GPU 限制或统一尺寸。 |
| longest_side | 设定最长边的目标像素值，仅在 scale_to_longest_side = True 时生效。 |