From 1d0fcce58f144b862fbb992933766220cc32a3ef Mon Sep 17 00:00:00 2001 From: zhangheng Date: Fri, 15 May 2026 19:50:45 +0800 Subject: [PATCH] fix(image): fix readme --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 60c5df4..24a686a 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,24 @@ bash scripts/run_openai_gpt_image2_multi.sh - `IMAGE_SIZE` - `REFERENCE_IMAGE` 或 `REFERENCE_IMAGES` +`IMAGE_SIZE` 可选值： + +- 比例值：`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5`、`2:1`、`1:2`、`21:9`、`9:21` +- 像素值：`宽x高` 格式，只要满足官方约束即可。OpenAI 官方 `gpt-image-2` 的常用尺寸示例是 `1024x1024`、`1536x1024`、`1024x1536`、`2048x2048`、`2048x1152`、`3840x2160`、`2160x3840`，以及 `auto` + +官方约束： + +- 最大边长 `<= 3840px` +- 宽高都必须是 `16px` 的倍数 +- 长边 / 短边比值不能超过 `3:1` +- 总像素数必须在 `655,360` 到 `8,294,400` 之间 + +建议： + +- `IMAGE_REQUEST_STYLE=openai` 时，比例值会自动映射成兼容像素尺寸。 +- 需要更稳定的输出尺寸时，优先直接写像素值。 +- `4096x2304`、`4096x4096` 这类超过 `3840px` 边长上限的尺寸，不属于 OpenAI 官方 `gpt-image-2` 的可选值。 + 详细说明见 [docs/usage.md](docs/usage.md)。 ## 仓库约定