PetForge / 绘宠

AI 图像生成提示词工坊 — 用 gpt-image-2 或 Nano Banana 制作桌面宠物（Codex Pet）精灵图。

项目结构

├── example/                  # 示例工作流产物（5 步）
├── src/
│   ├── test_relay.py         # 中转站连通性测试
│   ├── cxpet_generate.ipynb  # 交互式生成 Notebook
│   ├── requirements.txt      # Python 依赖
│   └── output/               # 生成图片（gitignore）
├── out/                      # 额外输出（gitignore）
├── cxpet-gpt-img.md          # gpt-image-2 提示词文档
├── cxpet-nanobanana.md       # Nano Banana 提示词文档
└── .env                      # API Key 配置（gitignore）

快速开始

1. 配置环境

# Windows .venv
.venv\Scripts\activate
pip install -r src/requirements.txt

2. 测试中转站

python src/test_relay.py

通过后在 src/output/ 看到 test_cat.png 即表示连通。

3. 运行 Notebook

jupyter notebook src/cxpet_generate.ipynb

按 Cell 顺序执行：参考图 → 序列帧 → 逐个动作 → 多角色图标。

提示词文档

文件	适用模型	说明
cxpet-gpt-img.md	gpt-image-2	含 Edit 端点一致性策略、API 调用示例
cxpet-nanobanana.md	Nano Banana (Gemini)	含对话式编辑工作流、白边描边技巧

工作流

角色参考图 → 动画序列帧 → 逐个动作生成 → 多角色图标 → 抠图合成 GIF

示例

example/ 目录包含完整工作流的中间产物：

文件	内容
01.png	4 姿势角色参考图
02.png	待机 + 跑步序列帧（绿幕）
03.gif	动作列表面板
04.png	多角色选择界面
05.jpg	工作流讨论记录