65 lines
1.8 KiB
Markdown
65 lines
1.8 KiB
Markdown
# 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/` 是本地参考图目录，默认不纳入版本控制。
|