gen-image/README.md

# gen-image · 生图 Skill

通过大模型中转站，直接调用 OpenAI 图片接口生图。文生图 / 图生图 / 局部重绘 / 透明背景 / 1K-4K 常用尺寸 / 可选 style 风格参数，零第三方依赖。

## 快速开始

```bash
# 1. 配置凭证
cp .env.example .env
# 编辑 .env，填入 IMAGE_API_BASE_URL、IMAGE_API_KEY

# 2. 文生图
python3 scripts/gen_image.py "a cozy cabin in snowy mountains, golden hour, cinematic" \
  --size 2k-landscape --quality high

# 3. 图生图 / 编辑
python3 scripts/gen_image.py "把背景换成星空" --edit input.png --size 1k-square

# 4. 局部重绘（mask 透明处为重绘区域）
python3 scripts/gen_image.py "戴上一顶红帽子" --edit input.png --mask mask.png

# 5. 可选 style 参数（部分模型/中转支持）
python3 scripts/gen_image.py "a studio portrait, natural light" --style natural --size 1k-portrait
```

图片保存到 `output/`，脚本打印完整路径。

## 配置项（.env）

| 变量 | 说明 |
|------|------|
| `IMAGE_API_BASE_URL` | 中转站基址，如 `https://your-relay.com`（自动补 `/v1/images/...`） |
| `IMAGE_API_KEY` | 中转站 API Key |
| `IMAGE_MODEL` | 默认模型，默认 `gpt-image-2`，可用 `--model` 覆盖 |

## 参数

`--size` `--n` `--quality` `--background transparent` `--style` `--edit`(可多次) `--mask` `--model` `--output`
详见 `python3 scripts/gen_image.py --help` 与 `SKILL.md`。

## 尺寸与风格

`--size` 支持直接传像素值，也支持别名：

| 规格 | 常用别名 |
|------|----------|
| 1K | `1k-square`、`1k-landscape`、`1k-portrait` |
| 2K | `2k-square`、`2k-landscape`、`2k-portrait`、`2k-wide`、`2k-tall` |
| 4K | `4k-square`、`4k-landscape`、`4k-portrait`、`4k-wide`、`4k-tall`、`4k-uhd`、`4k-uhd-portrait` |

风格优先写进 prompt；目标模型或中转明确支持独立风格字段时，可额外传 `--style natural`、`--style vivid`、`--style anime`、`--style photorealistic` 等。

## 安全

`.env` 与 `output/` 已在 `.gitignore` 中，不会提交。切勿把 API Key 写进代码或对话。