# gpt-image2-cli

**Repository Path**: a-summer-wind/gpt-image2-cli

## Basic Information

- **Project Name**: gpt-image2-cli
- **Description**: gpt image2 skill 是一个面向 AI 编程代理的开源 Skill，专门用于让Claude Code、Codex、WorkBuddy 等工具自主调用 chatgpt-image2 CLI，完成 gpt-image-2 的文生图与图片编辑任务。它支持自动选择生成或编辑模式、结构化参数映射、标准化 JSON 输出，以及稳定的代理集成体验。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gpt-generate-image Skill

一个通用的 AI 图片生成 Skill，教 AI 理解 **OpenAI Images API 协议**，根据用户配置的 base URL 和 API key 自动编写请求脚本，生成或编辑图片。

## 它做什么

- **文生图**：给定文字描述，生成图片
- **图片编辑**：给定原图 + 指令，修改图片（加对象、改风格、蒙版重绘、多图融合等）
- **通用协议**：基于 OpenAI Images API 规范，兼容所有 OpenAI 兼容端点（官方、中转站、代理）
- **自动适配**：AI 根据 base URL 自动判断同步/异步/上传模式，无需硬编码 provider

## 核心文件

- `SKILL.md` — Skill 定义文件，包含 API 协议参考、脚本模板、调用流程

## 安装

### 方式一：让 AI 帮你安装（最简单）

把 `SKILL.md` 文件丢给你的 AI 工具，说：

> 帮我把这个 skill 安装到你的 skills 目录里

AI 会自动找到它的 skill 存放路径并完成安装。

### 方式二：Windsurf

```powershell
# 创建 skill 目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codeium\windsurf\skills\gpt-generate-image"

# 复制 SKILL.md
Copy-Item SKILL.md "$env:USERPROFILE\.codeium\windsurf\skills\gpt-generate-image\SKILL.md"
```

重启 Windsurf 生效。

### 方式三：Codex (OpenAI)

```bash
# Codex 的 instructions 目录
mkdir -p ~/.codex/instructions

# 复制为全局指令
cp SKILL.md ~/.codex/instructions/gpt-generate-image.md
```

或在项目根目录放置：

```bash
cp SKILL.md .codex/instructions/gpt-generate-image.md
```

### 方式四：Claude Code

```bash
# Claude Code 的 CLAUDE.md 机制
# 方案 A：追加到全局指令
cat SKILL.md >> ~/.claude/CLAUDE.md

# 方案 B：项目级指令
cp SKILL.md .claude/gpt-generate-image.md
# 然后在 .claude/CLAUDE.md 中加一行引用：
# @gpt-generate-image.md
```

### 方式五：OpenClaw / QClaw

```bash
# OpenClaw / QClaw 使用 .claw/skills/ 目录
mkdir -p .claw/skills/gpt-generate-image

cp SKILL.md .claw/skills/gpt-generate-image/SKILL.md
```

全局安装：

```bash
mkdir -p ~/.claw/skills/gpt-generate-image
cp SKILL.md ~/.claw/skills/gpt-generate-image/SKILL.md
```

## 配置

安装 skill 后，在项目根目录创建 `config/image-api.json`：

```json
{
  "baseUrl": "https://api.openai.com/v1",
  "apiKey": "sk-your-key-here",
  "model": "gpt-image-2",
  "defaultOutputDir": "./generated"
}
```

| 字段 | 必填 | 说明 |
|------|------|------|
| `baseUrl` | 是 | API 基础地址（如 `https://api.openai.com/v1`、`https://www.dmxapi.cn/v1`） |
| `apiKey` | 是 | Bearer token |
| `model` | 否 | 默认模型名，默认 `gpt-image-2` |
| `defaultOutputDir` | 否 | 默认输出目录，默认 `./generated` |

配置好后，对 AI 说"生成一张图片"即可触发 skill。