Muse Image 处理长宽比异常的解决方案

当 Muse Image 输出的图片比例与预期不符时，常见表现是拉伸变形、边缘裁切、内容被压缩或尺寸回传不一致。处理思路不是直接调一个参数，而是先确定异常发生在请求、预处理还是后处理环节。通常三步能解决：显式指定目标比例、输入图用平铺填充而非拉伸、输出后校验实际尺寸。

Muse Image 长宽比异常核心在于模型支持的尺寸集合与画布填充策略。判断顺序：请求回传尺寸是否正确，输入预处理是否拉伸内容，输出是否被裁剪。不要依赖默认值；建议在模型允许的尺寸内显式设置目标比例，对输入图做 padding，出图后用独立工具复核尺寸。

先判断异常类型

不同现象对应的排查方向不一样。

图片被横向或纵向拉伸：说明输入图被直接 resize 到目标尺寸，模型没有保持原比例。优先检查预置的图生图流程是否用了 resize。
边缘内容丢失：说明模型或后处理做了中心裁剪。优先检查请求参数里是否有 crop 或 strict 选项。
生成图片周围出现黑边或透明区域：说明目标尺寸不符合模型允许的画幅，模型用补边方式填充。优先核对模型支持的长宽比范围。
回传尺寸与请求参数不一致：可能是参数名无效，或模型限定输出范围。优先查阅当前环境的接口说明。

检查请求参数与模型支持范围

大多数生成接口接受宽高参数或比例参数，但名称和限制不一致。通常模型文档会列出允许的尺寸集合，例如 1024x1024、768x1344 这类固定档位。建议先查看文档确认支持哪些档位，再决定请求参数。

一个通用请求骨架（参数名随环境调整）：

{
  "prompt": "…",
  "width": 1024,
  "height": 768,
  "aspect_ratio": "4:3"
}

如果接口同时支持 width/height 与 aspect_ratio，以宽高为准。设置后，在返回结果中读取输出图的 width/height。也可以用本地 PIL 或文件信息核对尺寸，确认请求是否真正生效。若发现设置了比例但输出仍是默认画幅，优先去掉多余参数，只保留一组。

风险边界：有些模型只接受固定档位，宽高不合法时会静默取近似值，这时看起来像是长宽比异常，实际是档位不匹配。不要盲目扩大数值范围，先找文档中的尺寸表。

修正输入图的预处理方式

图生图或参考图输入时，模型通常会把图片缩放或裁剪到预设尺寸。如果原图比例和目标比例不一致，直接 resize 会导致拉伸。

建议预处理阶段采用 letterbox 填充，把原图完整放入目标画布，避免内容变形。下面是使用 PIL 的示例：

from PIL import Image, ImageOps

def pad_to_target(image, target_size=(1024, 1024), fill=(127, 127, 127)):
    return ImageOps.pad(image, target_size, color=fill)

调用这个函数后，输入图会被缩放并居中填充到目标尺寸，不会改变内容比例。执行前记录原图尺寸，执行后再次检查输出尺寸，确认填充后的宽高符合目标。如果模型要求必须是正方形，但原图是 16:9，先填充到正方形再送入模型，能避免内容被裁。

注意：填充颜色可能影响模型生成效果，建议使用中性灰色。如果模型支持透明背景，也可以采用透明填充，但需要确认所用框架支持 alpha 通道。

输出后处理与尺寸校验

模型返回结果后，建议先读图片实际尺寸，再决定是否需要二次处理。部分模型会在输出阶段自行裁剪或补边，单独靠请求参数不一定能完全控制。

from PIL import Image
img = Image.open("output.png")
print(img.size)

如果输出尺寸与目标不同，需要根据场景选择处理方式：目标画布要求严格时，用中心裁剪或再次 pad 到目标尺寸；如果只是查看或分享，可以保留模型输出的原始比例，不再额外处理。

后处理操作要固定为完整流程，不能只在本地手工改图。否则下次生成时还会遇到同一问题。建议把预处理、调用接口、后处理封装成一个脚本，每次生成后自动核对尺寸。

最后把排查顺序固定下来：先看请求参数是否生效，再看输入图片预处理是否拉伸，最后检查输出后处理是否截断。Muse Image 的长宽比异常不是单一参数能解决的，需要结合当前模型支持的尺寸范围和实际画布逻辑来判断。遇到问题先保留原图尺寸和请求记录，方便对比定位。