diff --git a/skills/oneinaiimage.md b/skills/oneinaiimage.md index f835155..7cea265 100644 --- a/skills/oneinaiimage.md +++ b/skills/oneinaiimage.md @@ -1,312 +1,250 @@ -# ikunimage - AI 图片生成器 +# oneimage - AI 图片生成器 -**Claude Code Skill — 通过 ikun API 调用 Gemini 图像模型,支持文生图与图生图** +**Claude Code Skill — 通过 oneinai API 调用 Gemini 图像模型,支持文生图与图生图** -📋 简介 +## 📋 简介 -ikunimage 是一款 Claude Code Skill 插件,通过 [ikun API]() 调用 **NanoBananaPro(Gemini 3 Pro Image Preview)** 模型,在 Claude Code 对话中直接生成高质量图片。支持文生图、图生图编辑、批量并发等多种模式。 +oneimage 是一款 Claude Code Skill 插件,通过 [oneinai API](https://api.oneinai.com) 调用 **NanoBananaPro(Gemini 3 Pro Image Preview)** 模型,在 Claude Code 对话中直接生成高质量图片。支持文生图、图生图编辑、批量并发等多种模式。 -## 🔗 相关链接 +## 🔗 相关链接 -资源| 地址 ----|--- -GitHub 仓库| [deijing/ikunimage]() -ikun API| [api.ikuncode.cc]() - -## ✨ 功能特点 +| 资源 | 地址 | +| --- | --- | +| GitHub 仓库 | [deijing/oneimage](https://github.com/deijing/oneimage) | +| oneinai API | | +| oneinai 控制台 | | - * ✅ **文生图** :用自然语言描述场景,AI 生成对应图片 - * ✅ **图生图** :上传本地图片 + 编辑描述,AI 修改生成新图片 - * ✅ **10 种宽高比** :1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 5:4 / 4:5 - * ✅ **3 档分辨率** :1K(快速预览)/ 2K(推荐)/ 4K(超高清) - * ✅ **文字渲染** :支持在图片中渲染中文文字(招牌、海报、标语等) - * ✅ **并发批量** :多张图片并发生成,大幅缩短总耗时 - * ✅ **配置文件管理** :API Key 存储在本地配置文件,安全便捷 +## ✨ 功能特点 -## 📋 前置要求 +- ✅ **文生图**:用自然语言描述场景,AI 生成对应图片 +- ✅ **图生图**:上传本地图片 + 编辑描述,AI 修改生成新图片 +- ✅ **10 种宽高比**:1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 5:4 / 4:5 +- ✅ **3 档分辨率**:1K(快速预览)/ 2K(推荐)/ 4K(超高清) +- ✅ **文字渲染**:支持在图片中渲染中文文字(招牌、海报、标语等) +- ✅ **并发批量**:多张图片并发生成,大幅缩短总耗时 +- ✅ **配置文件管理**:API Key 存储在本地配置文件,安全便捷 - * [Claude Code]() CLI 已安装 - * Python 3.10+ - * ikun API Key(从 [api.ikuncode.cc]() 获取) +## 📋 前置要求 -## 🛠️ 安装 +- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 已安装 +- Python 3.10+ +- oneinai API Key(在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建) -### 第一步:下载 Skill +## 🛠️ 安装 -bash - - - # 如果目录不存在,先创建 - mkdir -p ~/.claude/skills - - # 克隆 ikunimage 到 skills 目录 - cd ~/.claude/skills - git clone https://github.com/deijing/ikunimage.git +### 第一步:下载 Skill -1 -2 -3 -4 -5 -6 +```bash +# 如果目录不存在,先创建 +mkdir -p ~/.claude/skills + +# 克隆 oneimage 到 skills 目录 +cd ~/.claude/skills +git clone https://github.com/deijing/oneimage.git +``` 安装完成后目录结构如下: - - - ~/.claude/skills/ikunimage/ - ├── SKILL.md # Skill 定义文件 - ├── scripts/ - │ ├── generate_ikun.py # 文生图脚本 - │ └── generate_ikun_edit.py # 图生图脚本 - └── references/ - └── api-reference.md # API 参考文档 -1 -2 -3 -4 -5 -6 -7 +``` +~/.claude/skills/oneimage/ +├── SKILL.md # Skill 定义文件 +├── scripts/ +│ ├── generate_oneinai.py # 文生图脚本 +│ └── generate_oneinai_edit.py # 图生图脚本 +└── references/ + └── api-reference.md # API 参考文档 +``` -### 第二步:安装依赖 +### 第二步:安装依赖 -bash - - - pip install httpx +```bash +pip install httpx +``` -1 +### 第三步:配置 API Key -### 第三步:配置 API Key - -三种方式任选其一: +三种方式任选其一。 **方式 A:交互式配置(推荐)** -bash - - - python ~/.claude/skills/ikunimage/scripts/generate_ikun.py --setup +```bash +python ~/.claude/skills/oneimage/scripts/generate_oneinai.py --setup +``` -1 - -按提示输入你的 API Key 即可,配置会保存到 `~/.ikunimage/config.json`。 +按提示输入你的 API Key 即可,配置会保存到 `~/.oneimage/config.json`。 **方式 B:手动创建配置文件** -bash - - - mkdir -p ~/.ikunimage - echo '{"api_key": "sk-你的key"}' > ~/.ikunimage/config.json - -1 -2 +```bash +mkdir -p ~/.oneimage +echo '{"api_key": "sk-你的key"}' > ~/.oneimage/config.json +``` **方式 C:环境变量** -bash - - - export IKUN_API_KEY="sk-你的key" +```bash +export ONEINAI_API_KEY="sk-你的key" +``` -1 +> 💡 **API Key 加载优先级** +> `--api-key` 命令行参数 > `ONEINAI_API_KEY` 环境变量 > `~/.oneimage/config.json` 配置文件 -💡 API Key 加载优先级 +## 📖 使用方法 -`--api-key` 命令行参数 > `IKUN_API_KEY` 环境变量 > `~/.ikunimage/config.json` 配置文件 - -## 📖 使用方法 - -### 在 Claude Code 中使用 +### 在 Claude Code 中使用 安装配置完成后,在 Claude Code 对话中输入: - - - /ikunimage -1 +``` +/oneimage +``` 然后描述你想要的图片即可。例如: - * "画一张江南水乡的风景" - * "生成一张 4K 超宽屏的故宫雪景" - * "批量生成 5 张不同风格的古风人像" +- "画一张江南水乡的风景" +- "生成一张 4K 超宽屏的故宫雪景" +- "批量生成 5 张不同风格的古风人像" 图生图编辑: - * "编辑 /path/to/photo.jpg,把背景改成竹林" +- "编辑 /path/to/photo.jpg,把背景改成竹林" -### 独立脚本使用 +### 独立脚本使用 也可以脱离 Claude Code,直接在命令行中调用。 -**文生图** : +**文生图**: -bash - - - python ~/.claude/skills/ikunimage/scripts/generate_ikun.py \\ - -p "一位中国女性,身穿汉服,站在竹林中,晨雾缭绕" \\ - -ar 3:4 \\ - -s 2K \\ - -o ./output.png +```bash +python ~/.claude/skills/oneimage/scripts/generate_oneinai.py \ + -p "一位中国女性,身穿汉服,站在竹林中,晨雾缭绕" \ + -ar 3:4 \ + -s 2K \ + -o ./output.png +``` -1 -2 -3 -4 -5 +**图生图**: -**图生图** : +```bash +python ~/.claude/skills/oneimage/scripts/generate_oneinai_edit.py \ + -i ./photo.jpg \ + -p "将背景改为雪景,保持人物不变" \ + -ar 3:4 \ + -o ./edited.png +``` -bash - - - python ~/.claude/skills/ikunimage/scripts/generate_ikun_edit.py \\ - -i ./photo.jpg \\ - -p "将背景改为雪景,保持人物不变" \\ - -ar 3:4 \\ - -o ./edited.png +**批量生成**: -1 -2 -3 -4 -5 +```bash +# 准备任务文件 tasks.json +cat > tasks.json << 'EOF' +[ + {"prompt": "描述1", "aspect_ratio": "3:4", "size": "2K", "output": "./out1.png"}, + {"prompt": "描述2", "aspect_ratio": "16:9", "size": "1K", "output": "./out2.png"} +] +EOF -**批量生成** : +# 执行批量生成 +python ~/.claude/skills/oneimage/scripts/generate_oneinai.py \ + --batch tasks.json \ + --workers 2 +``` -bash - - - # 准备任务文件 tasks.json - cat > tasks.json << 'EOF' - [ - {"prompt": "描述1", "aspect_ratio": "3:4", "size": "2K", "output": "./out1.png"}, - {"prompt": "描述2", "aspect_ratio": "16:9", "size": "1K", "output": "./out2.png"} - ] - EOF - - # 执行批量生成 - python ~/.claude/skills/ikunimage/scripts/generate_ikun.py \\ - --batch tasks.json \\ - --workers 2 +## 📐 参数速查 -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 +### 文生图(`generate_oneinai.py`) -## 📐 参数速查 +| 参数 | 简写 | 说明 | 默认值 | +| --- | --- | --- | --- | +| `--setup` | | 交互式配置 API Key | | +| `--api-key` | | 指定 API Key | 从配置加载 | +| `--prompt` | `-p` | 图片描述(必填) | | +| `--aspect-ratio` | `-ar` | 宽高比 | `1:1` | +| `--size` | `-s` | 分辨率(1K/2K/4K) | `2K` | +| `--output` | `-o` | 输出路径 | `output.png` | +| `--batch` | `-b` | 批量任务 JSON 文件 | | +| `--workers` | `-w` | 并发数 | 自动(默认 2) | +| `--retry` | `-r` | 重试次数(0-10) | `3` | -### 文生图 (generate_ikun.py) +### 图生图(`generate_oneinai_edit.py`) -参数| 简写| 说明| 默认值 ----|---|---|--- -`--setup`| | 交互式配置 API Key| -`--api-key`| | 指定 API Key| 从配置加载 -`--prompt`| `-p`| 图片描述(必填)| -`--aspect-ratio`| `-ar`| 宽高比| `1:1` -`--size`| `-s`| 分辨率(1K/2K/4K)| `2K` -`--output`| `-o`| 输出路径| `output.png` -`--batch`| `-b`| 批量任务 JSON 文件| -`--workers`| `-w`| 并发数| 自动(默认 2) -`--retry`| `-r`| 重试次数(0-10)| `3` - -### 图生图 (generate_ikun_edit.py) +| 参数 | 简写 | 说明 | 默认值 | +| --- | --- | --- | --- | +| `--setup` | | 交互式配置 API Key | | +| `--api-key` | | 指定 API Key | 从配置加载 | +| `--input` | `-i` | 输入图片路径(必填) | | +| `--prompt` | `-p` | 编辑描述(必填) | | +| `--aspect-ratio` | `-ar` | 输出宽高比 | `1:1` | +| `--output` | `-o` | 输出路径 | `output.png` | +| `--batch` | `-b` | 批量任务 JSON 文件 | | +| `--workers` | `-w` | 并发数 | 自动(默认 2) | +| `--retry` | `-r` | 重试次数(0-10) | `3` | -参数| 简写| 说明| 默认值 ----|---|---|--- -`--setup`| | 交互式配置 API Key| -`--api-key`| | 指定 API Key| 从配置加载 -`--input`| `-i`| 输入图片路径(必填)| -`--prompt`| `-p`| 编辑描述(必填)| -`--aspect-ratio`| `-ar`| 输出宽高比| `1:1` -`--output`| `-o`| 输出路径| `output.png` -`--batch`| `-b`| 批量任务 JSON 文件| -`--workers`| `-w`| 并发数| 自动(默认 2) -`--retry`| `-r`| 重试次数(0-10)| `3` - -⚠️ 互斥参数 +> ⚠️ **互斥参数** +> `--prompt` 和 `--batch` 互斥,单图模式和批量模式必须二选一。 -`--prompt` 和 `--batch` 互斥,单图模式和批量模式必须二选一。 +## 📊 分辨率参考 -## 📊 分辨率参考 +### 1K(快速预览) -### 1K(快速预览) +| 宽高比 | 分辨率 | +| --- | --- | +| 1:1 | 1024×1024 | +| 16:9 | 1376×768 | +| 9:16 | 768×1376 | +| 4:3 | 1200×896 | +| 3:4 | 896×1200 | -宽高比| 分辨率 ----|--- -1:1| 1024×1024 -16:9| 1376×768 -9:16| 768×1376 -4:3| 1200×896 -3:4| 896×1200 - -### 2K(推荐) +### 2K(推荐) -宽高比| 分辨率 ----|--- -1:1| 2048×2048 -16:9| 2752×1536 -9:16| 1536×2752 -4:3| 2400×1792 -3:4| 1792×2400 - -### 4K(超高清) +| 宽高比 | 分辨率 | +| --- | --- | +| 1:1 | 2048×2048 | +| 16:9 | 2752×1536 | +| 9:16 | 1536×2752 | +| 4:3 | 2400×1792 | +| 3:4 | 1792×2400 | -宽高比| 分辨率 ----|--- -1:1| 4096×4096 -16:9| 5504×3072 -9:16| 3072×5504 -4:3| 4800×3584 -3:4| 3584×4800 - -## 🖼️ 图生图支持格式 +### 4K(超高清) -格式| 支持| 备注 ----|---|--- -JPG / JPEG| ✅| 推荐 -PNG| ✅| 推荐 -WebP| ✅| -GIF| ✅| 仅使用第一帧 - -💡 建议 +| 宽高比 | 分辨率 | +| --- | --- | +| 1:1 | 4096×4096 | +| 16:9 | 5504×3072 | +| 9:16 | 3072×5504 | +| 4:3 | 4800×3584 | +| 3:4 | 3584×4800 | -图片大小推荐 < 4MB,过大可能导致上传变慢或超时。 +## 🖼️ 图生图支持格式 -## 常见问题 +| 格式 | 支持 | 备注 | +| --- | --- | --- | +| JPG / JPEG | ✅ | 推荐 | +| PNG | ✅ | 推荐 | +| WebP | ✅ | | +| GIF | ✅ | 仅使用第一帧 | -### 提示 "未找到 API Key"? +> 💡 **建议** +> 图片大小推荐小于 4MB,过大可能导致上传变慢或超时。 + +## ❓ 常见问题 + +### 提示「未找到 API Key」? 运行交互式配置命令: -bash - - - python ~/.claude/skills/ikunimage/scripts/generate_ikun.py --setup +```bash +python ~/.claude/skills/oneimage/scripts/generate_oneinai.py --setup +``` -1 - -### 请求超时? +### 请求超时? 4K 图片生成较慢,脚本已设置充足的超时时间。如果仍然超时,可降低分辨率到 2K 或 1K。 -### 收到 429 错误? +### 收到 429 错误? 触发了 API 频率限制。脚本会自动指数退避重试(默认 3 次)。可加 `--retry 5` 增加重试次数。 -### 更多问题 +### 更多问题 -请查看 [FAQ]() 或联系[售后支持]()。 +请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。 diff --git a/support/after-sales.md b/support/after-sales.md index f858a48..03cefd7 100644 --- a/support/after-sales.md +++ b/support/after-sales.md @@ -17,13 +17,7 @@ * 获取最新消息 * 与其他用户交流 -### QQ 群 - * **QQ 群号** :请扫描下方二维码加入 - -### 扫码加群 - -![联系方式二维码](https://docs.ikuncode.cc/images/tu5.png) ## 服务时间