Update gen-image skill catalog entry
This commit is contained in:
+21
-32
@@ -1,55 +1,44 @@
|
||||
# gen-image · 生图 Skill
|
||||
|
||||
通过大模型中转站,直接调用 OpenAI 图片接口生图。文生图 / 图生图 / 局部重绘 / 透明背景 / 1K-4K 常用尺寸 / 可选 style 风格参数,零第三方依赖。
|
||||
通过大模型中转站,直接调用 OpenAI 图片接口生图。文生图 / 图生图 / 局部重绘 / 透明背景,零第三方依赖。
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
# 1. 配置凭证
|
||||
cp .env.example .env
|
||||
# 编辑 .env,填入 IMAGE_API_BASE_URL、IMAGE_API_KEY
|
||||
# 1. 文生图
|
||||
./gen.sh "a cozy cabin in snowy mountains, golden hour, cinematic" \
|
||||
--size 1536x1024 --quality high
|
||||
|
||||
# 2. 文生图
|
||||
python3 scripts/gen_image.py "a cozy cabin in snowy mountains, golden hour, cinematic" \
|
||||
--size 2k-landscape --quality high
|
||||
# 2. 图生图 / 编辑
|
||||
./gen.sh "把背景换成星空" --edit input.png
|
||||
|
||||
# 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
|
||||
# 3. 局部重绘(mask 透明处为重绘区域)
|
||||
./gen.sh "戴上一顶红帽子" --edit input.png --mask mask.png
|
||||
```
|
||||
|
||||
图片保存到 `output/`,脚本打印完整路径。
|
||||
|
||||
## 配置项(.env)
|
||||
## 配置(每人用自己的中转站账号)
|
||||
|
||||
**TD工具箱用户(推荐):** 在工具箱「中转」里,给一个支持 OpenAI 图片接口的中转分组勾选 **☑ 在 Codex 中用于生图** 并保存——工具箱自动把该分组的 base_url+密钥写进本技能的 `.env`,无需手动配置。重装技能后工具箱会自动重写。
|
||||
|
||||
**手动方式(无工具箱):** `cp .env.example .env`,填三项:
|
||||
|
||||
| 变量 | 说明 |
|
||||
|------|------|
|
||||
| `IMAGE_API_BASE_URL` | 中转站基址,如 `https://your-relay.com`(自动补 `/v1/images/...`) |
|
||||
| `IMAGE_API_KEY` | 中转站 API Key |
|
||||
| `IMAGE_API_BASE_URL` | 你的中转站基址,如 `https://api.xxx.com`(自动补 `/v1/images/...`) |
|
||||
| `IMAGE_API_KEY` | 你的中转站 API Key |
|
||||
| `IMAGE_MODEL` | 默认模型,默认 `gpt-image-2`,可用 `--model` 覆盖 |
|
||||
|
||||
读取优先级:**环境变量 > skill 目录 `.env`**。CI/临时场景可直接 `export IMAGE_API_KEY=...`。
|
||||
|
||||
## 参数
|
||||
|
||||
`--size` `--n` `--quality` `--background transparent` `--style` `--edit`(可多次) `--mask` `--model` `--output`
|
||||
`--size` `--n` `--quality` `--background transparent` `--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 写进代码或对话。
|
||||
- 凭证存在本技能目录的 `.env`(工具箱写入时权限 600),已被 `.gitignore` 忽略,不进 git。
|
||||
- 分发包只含 `.env.example` 模板,绝不含真实 Key。
|
||||
- 切勿把 API Key 写进代码、日志或对话。
|
||||
|
||||
Reference in New Issue
Block a user