KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #claude-code #dsh #dsh-plugin #ai-agents #deepseek-harness #ai-agent #mcp #macos #cli

seedream-image-generator

★ 22 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Seedream 图像生成器

一个 Claude Skills 项目，让 AI 帮你通过文字描述生成高质量图像。

## 项目简介

Seedream 图像生成器通过整合火山引擎的 Doubao Seedream 4.0 API，将你的文字描述转换为高质量图像。这个技能支持单张和批量图像生成（最多 4 张），自动下载到项目的 `/pic` 文件夹，并提供灵活的尺寸和水印控制选项。

## 核心功能

🎨 **智能图像生成**
- 基于文字描述生成高质量图像
- 通过向 Agent 自然语言描述，可：
    - 支持多种预设尺寸（2K、1024x1024、2048x2048 等）
    - 支持自定义尺寸
    - 选择是否添加水印

📦 **批量生成**
- 一次生成多张相关图像
- 自动创建序列化图像（如四季变化、不同角度等）
- 智能文件命名，避免覆盖

💾 **自动管理**
- 自动检测项目根目录
- 自动创建 `/pic` 输出文件夹
- 时间戳命名，确保文件唯一性
- 自动下载并保存生成的图像

## 使用场景

当你需要：

- 🖼️ 根据文字描述生成图像、插画或艺术作品
- 🎨 创建视觉内容用于项目、演示或设计
- 📸 生成同一场景的多个变体（如四季变化、不同风格）
- 🎭 快速生成概念图、示意图或创意视觉

## 安装与使用

### 安装技能

将此项目复制到你的工作目录下的 `.claude/skills/` 文件夹中，记得删掉 README：

```
<你的项目根目录>/
└── .claude/
    └── skills/
        └── seedream-image-generator/    # 本技能包
            ├── scripts/
            │   └── generate_image.py
            ├── SKILL.md
```

### 使用技能

在 Claude Code 中，发送以下指令即可启用此技能：

```
使用 seedream-image-generator 创作图片
```

AI agent 会自动：
- 读取技能配置和指引
- 在需要时创建必要的目录结构（如 `pic/` 文件夹）
- 根据你的需求执行图像生成

### 准备工作

**重要**：首次使用前，你需要获取火山引擎 ARK API 密钥。

获取方式：
1. 访问：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
2. 创建或查看你的 ARK API 密钥

AI agent 会在首次使用时自动询问你的 API 密钥。

### 开始生成图像

配置完成后，直接告诉 AI 你想要生成的图像：

**示例 1：简单请求**
```
生成一张夕阳下的未来城市图像，有飞行汽车
```

**示例 2：批量生成**
```
生成 4 张图片，展示同一个花园庭院在四季的变化
```

**示例 3：自定义规格**
```
生成一张 2048x2048 的赛博朋克街道图像，不要水印
```

AI 将：
- 理解你的需求
- 调用 Seedream API 生成图像
- 自动下载到 `pic/` 文件夹
- 告诉你生成的文件路径

## 项目结构

### 技能包结构（位于 `.claude/skills/seedream-image-generator/`）

```
seedream-image-generator/
├── scripts/             # 核心脚本
│   └── generate_image.py
├── SKILL.md            # 技能详细文档（AI agent 会读取此文件）
```

AI agent 会在你的项目根目录创建以下结构：

```
<项目根目录>/
└── pic/                # 生成的图像存储目录（由 AI agent 自动创建）
    ├── seedream_20250112_143022.png
    ├── seedream_20250112_143530_1.png
    └── ...
```

**重要**：所有生成的图像存储在项目根目录的 `pic/` 文件夹中，便于管理和备份。

## 工作流程

1. **接收请求**：理解用户想要生成的图像描述
2. **确认 API 密钥**：确保已获取用户的 ARK API 密钥
3. **明确需求**：
   - 图像描述/提示词
   - 生成数量（1-4 张）
   - 图像尺寸偏好
   - 水印偏好
4. **执行生成**：调用 `generate_image.py` 脚本
5. **报告结果**：显示文件路径和生成统计信息

## 功能详解

**参数说明：**
- `prompt`（必需）：图像的文字描述
- `--api-key`：ARK API 密钥（也可使用 `ARK_API_KEY` 环境变量）
- `--size`：图像尺寸，选项包括：
  - `"2K"`（默认）
  - `"1024x1024"`
  - `"2048x2048"`
  - `"3104x1312"`（宽屏）
  - 自定义尺寸格式：`"{width}x{height}"`
- `--no-watermark`：禁用水印（默认启用水印）
- `--output-dir`：自定义输出目录（默认为 `项目根目录/pic`）

## 维护与更新

### 更新依赖

脚本需要以下 Python 包：
- `openai`（用于 API 客户端）
- `requests`（用于图像下载）

如果遇到模块错误，告诉 AI：
```
请安装所需的 Python 依赖包
```

AI agent 会自动安装：`pip install openai requests`

### 更改输出目录

如果你想更改图像保存位置，可以在请求时指定：
```
生成图像并保存到 custom_images 文件夹
```

或者直接使用 `--output-dir` 参数。

## 注意事项

- **API 密钥**：首次使用时，AI agent 会询问你的 ARK API 密钥。请确保密钥有效且有足够的配额。
- **网络连接**：生成和下载图像需要网络连接到 `ark.cn-beijing.volces.com`
- **内容政策**：确保提示词符合 API 的内容政策要求
- **文件存储**：所有生成的图像存储在项目根目录的 `pic/` 文件夹中，而非技能包目录内
- **技能位置**：确保技能包位于 `.claude/skills/seedream-image-generator/` 目录下

## 更多信息

详细的技术文档和使用说明请参考 `SKILL.md` 文件。

---

让 AI 帮你将创意想法转化为视觉现实，轻松生成高质量图像。

seedream-image-generator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README