内容
# 代码生成图像工具
在 Codex OAuth 桥接的基础上，基于您的 ChatGPT 订阅，无需 `OPENAI_API_KEY`。
一个引擎下的三个接口：Python SDK、`imagen` 命令行工具、MCP 服务器。
---
## 亮点
- **5 种批量模式** — 单个 / 并行 / 变体 / 链式 / 品牌并行（最适合连贯的网站部分）
- **4 种推理模式** — 原始（~20 秒）→ 最大（~3 分钟），根据提示形状自动选择
- **更好的透明度** — 绿色色键 + 主导去噪，相比洋红色默认值，毛发清洁度提高 54 倍
- **捆绑 AI 技能** — 在 `imagen setup` 时自动安装到 Claude Code / Codex / Claude Desktop
- **技能加载器** — 传递任何 `.md` 技能文件，主体合并到提示生成器
- **Codex 标记规范提示** — 14 个字段的结构化提示，可预测输出
- **MCP 服务器** — 一条命令即可接入 5 个 AI 客户端
---
## 安装
**一键安装（推荐）：**
```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/VelmoAI/codex-imagen/main/install.sh | sh
# Windows PowerShell
iwr https://raw.githubusercontent.com/VelmoAI/codex-imagen/main/install.ps1 | iex
```
这会安装 [uv](https://github.com/astral-sh/uv) （如果缺失）并运行 `imagen setup` — 在您的 AI 客户端中注册 MCP 服务器和捆绑技能。
**已经安装 uv：** `uvx codex-imagen setup`
**pip:** `pip install codex-imagen && imagen setup`
**从 GitHub（最新 main）：**
`pip install git+https://github.com/VelmoAI/codex-imagen.git && imagen setup`
---
## 快速入门（60 秒）
```python
from codex_imagen import imagen
# 一张图片
r = imagen(prompt="一个黄铜灯，编辑产品拍摄")
print(r.images[0].path)
# 一次调用生成 6 个品牌一致的网站部分
r = imagen(
prompt=["英雄", "关于", "功能", "画廊", "定价", "页脚"],
anchor="现代印度餐厅，温暖的陶土色和黄铜色调，编辑摄影",
batch_mode="branded-parallel",
parallel=3,
output_dir="./out/restaurant-site",
)
```
命令行工具：
```bash
imagen "一个黄铜灯"
imagen "一个黄铜灯" --transparent # RGBA PNG
imagen setup # 安装 MCP + 技能
imagen status # 每个客户端的安装状态
```
---
## 文档
- [批量模式](docs/modes.md) — 单个、并行、变体、链式、品牌并行
- [推理模式](docs/reasoning.md) — 原始、中等、高级、最大 — 含时间
- [透明度](docs/transparency.md) — 色键管道、去噪、复杂主题
- [技能](docs/skills.md) — 捆绑技能 + 外部技能加载器
- [MCP 服务器](docs/mcp.md) — 每个客户端的设置（Claude Code、Desktop、Codex、Cursor）
- [命令行工具参考](docs/cli.md) — 每个子命令和标志
- [SDK 参考](docs/sdk.md) — Python API、ImagenOptions、ImagenResult
- [为什么使用此工具而不是原生图像生成？](docs/comparison.md)
- [发布](docs/releasing.md)
---
## 许可证
MIT，版权（c）2026 wauwa。查看 [LICENSE](LICENSE) 以获取完整文本。
