调用腾讯混元文生图接口报“尺寸不支持”错误，是因width×height超出所选模型像素约束或格式不合法；需确认模型版本（如Hy-Image-3.0限512–2048且面积≤1024×1024，Hy-Image-3.5-Preview支持256–8192且面积上限4096×4096），严格按"${宽}x${高}"字符串格式传参，并校验面积与边界。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在调用腾讯混元文生图接口时收到“尺寸不支持”错误，说明传入的 width×height 超出当前所选模型的像素约束范围，或格式不符合要求，必须按模型能力边界重新校准参数。
确认当前使用的模型版本及尺寸限制
打开腾讯云控制台 → 进入「AI大模型」→「混元图像」服务页 → 查看已启用的模型名称。不同模型对 size 的支持差异极大：【Hy-Image-3.0 仅支持宽高均在 512–2048 像素之间，且面积 ≤ 1024×1024】；而 【Hy-Image-3.5-Preview 支持宽高 256–8192、面积上限达 4096×4096】。若你正用 v3.0 却传了 1200×1800（面积 2,160,000），必然报错。
检查 size 参数格式与取值合法性
确保请求体中 size 字段为字符串类型，格式严格为 "${宽}x${高}"，例如 "1024x768"，不能写成 "1024:768"、"1024*768" 或数字数组 [1024,768]。
用 Python 快速验证：运行 print(1200 * 1800
注意：即使单边在 512–2048 内，只要乘积超标，接口仍拒绝。例如 1500×700=1,050,000 > 1,048,576（1024²），就属于非法尺寸。
网页端生成时绕过尺寸报错的实操路径
第一步：进入腾讯混元官网「实时生图」界面 → 输入提示词 → 展开「高级参数」面板。
第二步：先取消勾选「启用自定义分辨率」，改用下拉菜单选择预设比例（如 9:16、16:9）→ 此时系统自动匹配 Hy-Image-3.0 允许的最接近尺寸，不会触发校验失败。
第三步：若必须精确像素，再勾选「启用自定义分辨率」，但手动输入前务必查表核对：例如小红书封面常用 1242×1588，其面积为 1,971,276，远超 1024²，【此时必须切换至 Hy-Image-3.5-Preview 模型才能合法提交】。
API 调用时动态适配尺寸的代码逻辑
方法一：在发送请求前插入尺寸合规性判断
if model == "hy-image-v3":
assert 512
方法二：自动降级策略——当检测到超标时，按比例缩放至最大允许面积内：
max_area = 1024 * 1024
scale = (max_area / (w * h)) ** 0.5
w_new = max(512, int(w * scale))
h_new = max(512, int(h * scale))
size = f"{w_new}x{h_new}"
这一步能保住构图比例，避免主体变形，比直接裁剪更安全。
