openai-imagelisted
Install: claude install-skill Sallyn0225/sallyn-skill
# OpenAI 兼容图像生成与编辑
用 OpenAI 兼容的 Images API 完成文生图(`/images/generations`)与图片编辑(`/images/edits`)。
本 skill 自带零依赖 Python 脚本(仅标准库),用户通过 `config.json` 自定义 base_url 与 api_key,
可对接 OpenAI 官方或任意 OpenAI 兼容的第三方图像服务(SiliconFlow、DeepInfra、OneAPI 网关等)。
## 工作流程
1. 检查配置:脚本目录 `scripts/` 的上一级(skill 根目录)是否存在 `config.json`。
- 不存在 → 先执行 `python scripts/openai_image.py init` 生成,再按用户要求填入 `base_url` / `api_key` / `model`(用户未提供 key 时,先询问用户)。
- 已存在 → 直接使用;不确定时运行 `python scripts/openai_image.py config` 查看(key 打码显示)。
2. 判断任务类型:
- 无输入图片 → `generate` 子命令。
- 有输入图片 → `edit` 子命令。
3. 构造提示词并执行脚本(见下方命令速查)。
4. 脚本把生成的��片保存到 `-o` 指定路径(默认 `image-<时间戳>.png`),并在 stdout 输出 JSON(含保存路径、usage、revised_prompt)。向用户报告保存的文件路径;用 markdown 内嵌图片或让用户打开文件查看结果。
## 命令速查
脚本路径:`<skill根目录>/scripts/openai_image.py`(下文用 `scripts/openai_image.py` 代指)。
```bash
# 初始化配置(把 config.example.json 复制为 config.json)
python scripts/openai_image.py init
# 查看当前配置(key 打码)
python scripts/openai_image.py config
# 文生图
python scripts/openai_image.py generate --prompt "一只戴贝雷帽的橘猫,水彩插画" -o cat.png
# 图片编辑(单图)
python scripts/openai_image.py edit --image photo.jpg --prompt "把背景换成星空" -o edited.png
# 图片编辑(多张参考图 + 遮罩)
python scripts/openai_image.py edit --image a.png --image b.png --mask mask.png \
--prompt "保留 a 的主体,背景换成 b 的沙滩场景" -o out.png
# 常用参数
python scripts/openai_image.py generate --prompt "..." --size 1024x1536 --quality high \
--n 2 --output-format jpeg -o ./out
```
提示词很长时用 `--prompt-file prompt.txt` 从 UTF-8 文本文件读取。
## 配置(config.j