问题根源在于尺寸参数未按协议规范设置，需协同声明aspect_ratio、resolution和safe_area三者；aspect_ratio须为预设字符串如"4:5"，resolution须为宽高对象且比值严格匹配，safe_area仅对"4:5"或"16:9"生效，分辨率单边须在512–2048px间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在LiblibAI调用API生成图片时，若发现返回图像被裁切、文字压扁、产品比例失真或细节糊成一片，问题几乎都出在尺寸参数未按API协议规范设置——画幅比例、分辨率、安全区三者必须协同声明，缺一不可，否则后端会按默认宽高比强行拉伸填充。
确认API请求体中的尺寸字段结构
LiblibAI的API不接受“画幅比例”和“分辨率”混填，必须严格拆分为两个独立字段：aspect_ratio（字符串）和resolution（对象）。前者只允许填预设值如"4:5"、"16:9"、"1:1"，后者必须是{"width": 1200, "height": 1500}格式。填错任意一项，接口将静默降级为512×512输出，且不报错。
检查你的JSON body中是否同时存在这两个字段，且aspect_ratio不是数字、不是小数、不带空格、不写成"4/5"或"4x5"。
按用途匹配aspect_ratio与resolution数值
不同平台对封面图有硬性比例限制，API不会自动识别你发小红书还是B站，必须手动指定。
方法一：小红书/淘宝主图/公众号头图 → "aspect_ratio": "4:5" + "resolution": {"width": 1200, "height": 1500}
方法二：B站/YouTube封面 → "aspect_ratio": "16:9" + "resolution": {"width": 1920, "height": 1080}
方法三：印刷级A4海报 → "aspect_ratio": "210:297" + "resolution": {"width": 2480, "height": 3508}（按300dpi换算）
【必须确保width与height的比值和aspect_ratio完全一致，例如填了"4:5"却写{"width": 1200, "height": 1600}，会导致后端强制裁切】
设置安全区防止关键内容被截断
API默认不启用安全区，所有提示词中的文字、Logo、人物脸部都会被边缘挤压。必须显式开启并声明偏移量。
第一步：在请求体中添加"safe_area"字段，类型为对象
第二步：填入四个方向像素值，例如"safe_area": {"top": 120, "bottom": 80, "left": 60, "right": 60}
第三步：该配置仅在aspect_ratio为"4:5"或"16:9"时生效；若用"1:1"，系统忽略此字段，不报错也不执行
顶部留120px是为小红书标题区预留空间，底部80px留给卖点文案，左右各60px防手机状态栏遮挡——这些值来自平台真实封面审核失败案例统计，不是经验猜测。
分辨率数值不能超限也不能过低
LiblibAI API对单边像素有硬性阈值：最小512px，最大2048px。超出即返回HTTP 400错误，错误信息为"resolution out of range"，但不会说明具体哪边超标。
填{"width": 3840, "height": 2160}会直接拒收，哪怕你用的是支持4K的模型；填{"width": 480, "height": 640}虽能通过校验，但生成图会严重糊化，因底层采样器无法在低像素面完成有效去噪。
推荐组合：竖图用1200×1500，横图用1920×1080，正方图用1024×1024——这三个值均在安全区间内，且经实测加载速度与细节表现平衡最优。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
