| aspect_ratio | 目标宽高比。选项包括 original（原始比例）、custom（自定义）或常用比例如 16:9、4:3、1:1 等。推荐根据目标平台设定（如社媒封面），若需自定义则配合下方两个比例值。 |
| proportional_width | custom 模式下的宽度比例值。 |
| proportional_height | custom 模式下的高度比例值。 |
| fit | 图像适配方式：letterbox（等比缩放+留边）、crop（裁剪填满）、fill（强制拉伸填满）。 |
| method | 缩放插值方式。
lanczos（兰索斯插值）：高质量缩放算法，边缘保留效果好，不过耗时稍高，推荐作为默认选择，适用于高清图像。
bicubic（双三次插值）：插值效果平滑自然，运算速度较快，质量比 lanczos 稍逊，适合对一般图像进行缩放。
bilinear（双线性插值）：计算速度快但效果较为粗糙，适用于图像预览以及轻量处理的场景。
box（方框平均插值）：采用简单平均的方式，主要用于降采样，速度快但质量一般。
hamming（汉明插值）：与 lanczos 类似，质量略低，边缘保留效果较好，适用于对边缘保持有一定要求的图像。
nearest（最近邻插值）：保留像素块，不进行平滑处理，适合像素风格图、遮罩图、分割图，不推荐用于真实图像的缩放。 |
| round_to_multiple | 将输出尺寸对齐为指定倍数（如 64、128），也可为 None 表示不对齐。推荐设为 64 或 128，便于后续模型输入要求。 |
| scale_to_side | 缩放目标指定逻辑：
longest：以图像最长边为基准缩放，保持宽高比。
shortest：以图像最短边为基准缩放，保持宽高比。
width：按图像宽度指定缩放值，高度按比例调整。
height：按图像高度指定缩放值，宽度按比例调整。
total_pixel(kilo pixel)：按指定的总像素数（千像素为单位），结合宽高比计算缩放后的宽和高。
None：不指定缩放目标，采用默认方式或由相关逻辑决定缩放行为。 |
| scale_to_length | 具体缩放数值，单位为像素或千像素（根据 scale_to_side 决定）。例如配合 longest 使用时设为 1024，可保证输出最大边 ≤1024。 |
| background_color | 背景填充颜色，格式如 #000000（黑）、#FFFFFF（白），用于 letterbox 或 fill 模式下边缘填充。 推荐使用视觉中性颜色，如灰、黑、白等；支持 16 进制色号。 |