# image-generate

这是一个基于 `gpt-image-2` 的图片生成小项目，支持 OpenAI-compatible / apicodex-compatible 接口。

## 安装

```bash
python3 -m pip install -r requirements.txt
```

## 入口

- `gpt_image2_generate.py`：单参考图 / 文生图 / 图生图入口
- `gpt_image2_generate_multi.py`：多参考图、多输出入口
- `scripts/*.sh`：常用启动脚本

## 快速开始

单参考图：

```bash
bash scripts/run_openai_gpt_image2_edit.sh
```

多参考图、多输出：

```bash
bash scripts/run_openai_gpt_image2_multi.sh
```

## 配置

复制 `.env.example` 为 `.env`，按需填写：

- `OPENAI_API_KEY`
- `OPENAI_BASE_URL`
- `IMAGE_PROMPT`
- `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)。

## 仓库约定

- `outputs/` 是运行产物目录，默认不纳入版本控制。
- `references/` 是本地参考图目录，默认不纳入版本控制。