GPT Image 2.5 尺寸怎么填?4K 和竖图报错排查
核对 GPT Image 2.5 的自定义尺寸限制,用本地脚本检查 1080×1920、精确 9:16 和 4K 参数,区分生成尺寸、导出尺寸与实验性分辨率。
GPT Image 2.5 自定义尺寸要同时满足整除、边长、比例和总像素限制。 两边必须是 16 的倍数,单边不超过 3840,长短边之比不超过 3:1,总像素在 655,360 到 8,294,400 之间。常用交付尺寸 1080x1920 就不满足整除要求。
本文适用于 OpenAI API 的 Flare 和 Sunburst,依据官方尺寸说明,核查日期为 2026 年 9 月 9 日。第三方应用或网关可能只开放其中一部分尺寸。
常用尺寸哪些能过校验?
| 尺寸 | 规则校验 | 原因或用途 |
|---|---|---|
1024x1024 | 通过 | 官方推荐的方图 |
1536x1024 | 通过 | 官方推荐的横图 |
1024x1536 | 通过 | 官方推荐的竖图 |
1080x1920 | 不通过 | 1080 不是 16 的倍数 |
1152x2048 | 通过 | 精确 9:16 |
1024x1824 | 通过 | 接近但不等于 9:16 |
3840x2160 | 通过,属实验性分辨率 | 达到总像素上限 |
4096x2160 | 不通过 | 单边和总像素均超限 |
512x512 | 不通过 | 总像素不足 |
3072x1024 | 通过 | 正好为 3:1 |
“通过”是本地按文档校验的结果,不是付费 API 实测。做尺寸对比时填具体值;auto 由服务选择,不适合用来控制尺寸变量。
发请求前,用脚本检查
保存为 check_size.py,无需第三方依赖,不联网:
import re
import sys
def size_errors(value):
if not re.fullmatch(r"[0-9]+x[0-9]+", value):
return ["Use WIDTHxHEIGHT with a lowercase x"]
width, height = map(int, value.split("x"))
if width <= 0 or height <= 0:
return ["Both dimensions must be positive"]
errors = []
if width % 16 or height % 16:
errors.append("Both edges must be divisible by 16")
if max(width, height) > 3840:
errors.append("Neither edge may exceed 3840")
if max(width, height) > 3 * min(width, height):
errors.append("The aspect ratio must not exceed 3:1")
if not 655360 <= width * height <= 8294400:
errors.append("Pixel count must be 655360 through 8294400")
return errors
if __name__ == "__main__":
value = sys.argv[1] if len(sys.argv) > 1 else "1080x1920"
errors = size_errors(value)
print("; ".join(errors) if errors else "Passes dimension rules")
raise SystemExit(1 if errors else 0)
运行 python check_size.py 1152x2048 即可检查。校验失败时返回非零退出码,便于工作流在生图前拦住不合规尺寸。脚本不能验证权限、额度、服务路由和画质。
4K 尺寸通过校验后,还要检查生成结果
3840x2160 是 16:9,共 8,294,400 像素。它满足规则,但官方将高于 2560x1440 的分辨率标为实验性支持。不要把“规则允许”写成每次都能成功、或一定比小图更清晰。
可以在 API 教程的示例中替换 size,记录返回尺寸、型号、quality 和 usage。比较两个模型时保持参数一致。型号选择与费用计算分别回答选什么模型和怎么核算账单。
生成尺寸和交付尺寸分开
必须交付 1080x1920 时,可先生成 1152x2048,再缩小导出。两者都是精确 9:16,不必为比例裁切,但缩放仍可能让小字变软。选择近似比例时,要明确裁切还是加边,不要直接拉伸。
重要文字和物体尽量留出边缘余量。验收最终导出文件,而不是只看生成预览;编辑器导出时可能改变压缩或铺上底色,透明图另看 PNG 透明度检查。
尺寸合法,为什么还是失败?
继续核对型号、API 方法和服务地址,再看错误正文。旧节点可能仍按固定尺寸列表校验,网关也可能有额外限制。语法、参数范围、权限和额度是不同问题。
需要隔离变量时,可在同一提示词下改用 1024x1024 比较;真正发请求会产生额外费用。对确定的无效参数错误,不要反复自动重试,先修正参数或不支持该尺寸的调用路径。
常见问题
- 能直接用 1080×1920 吗?
- 该尺寸不符合文档的 16 整除要求。1152×2048 是符合规则的精确 9:16 选项,交付时可再缩小。
- 3840×2160 属于支持范围吗?
- 符合尺寸限制,但高于 2560×1440 的分辨率被标为实验性支持。不能据此保证请求成功或输出画质。
- 校验脚本会收费吗?
- 不会。它只在本地检查整数尺寸,不调用 API,也不验证真实生成结果。


