# AI小分队 GPT-Image-2 Skill

这个 Skill 用于通过 `AI小分队` 的任务式图片接口生成图片，支持：

- 文生图
- 图生图
- 轮询任务结果
- 下载 OSS 图片到本地

## 适用场景

当你在 Claude Code、Codex、OpenClaw 等支持 Skills 的 AI 工具里，想直接说：

- 帮我生成一张图片
- 画一张海报
- 把这张图改成水彩风格
- 参考这张图生成一版新的

就可以安装这个 Skill。

## 安装方式

把下面这句话直接发给你的 AI 工具：

```text
帮我安装这个 skills：https://v.uzi.cool/downloads/uzi-gpt-image-skill/README.md ，然后帮我生成一张图片
```

如果你的工具支持本地 Skills 目录，也可以下载压缩包后手动解压：

- 下载地址：`https://v.uzi.cool/downloads/uzi-gpt-image-skill.zip`

## API Key 配置

配置文件路径：

- macOS / Linux: `~/.ai-uzi/config.json`
- Windows: `%USERPROFILE%\.ai-uzi\config.json`

写入以下内容：

```json
{"api_key":"这里粘贴你的Key"}
```

API Key 创建地址：

- `https://ai.uzi.cool/keys`

## 接口地址

```text
https://ai.uzi.cool
```

## 使用示例

### 文生图

```bash
node "$SKILL_DIR/scripts/generate.js" \
  --prompt "一只可爱的猫咪在阳光下打盹" \
  --size "1:1"
```

### 图生图

```bash
node "$SKILL_DIR/scripts/generate.js" \
  --prompt "把这张图改成水彩风格" \
  --size "1:1" \
  --image-url "https://example.com/photo.jpg"
```

## 参数说明

- `size` 默认 `1:1`
- `--image-url` 传入参考图 URL
- 支持比例：`1:1`、`16:9`、`9:16`
- 也支持直接传尺寸：`1024x1024`、`1536x1024`、`1024x1536`

## 耗时参考

- 方图文生图常见耗时 `20-60s`
- 横图和竖图通常更久
- 图生图常见耗时 `60-120s`
- 成功后会在当前目录生成 `generated-images/*.png`

## 返回结果

- 脚本会先发起任务
- 轮询任务状态直到完成
- 完成后从 OSS 下载图片到当前目录的 `generated-images/*.png`
- 图片线上地址当前保留约 `2` 小时