К основному содержанию
скилл CX Codex

byted-seedream-image-generate — скилл для Claude Code

Скилл byted-seedream-image-generate генерирует изображения из текстовых описаний через Volcano Engine Seedream. Поддерживает три версии моделей, пакетную генерацию, трансформацию стилей и веб-поиск в версии 5.0.

Apache-2.0 304 установок ★ 494 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add bytedance/agentkit-samples --skill byted-seedream-image-generate -a claude-code
Открыть на GitHub

Что делает byted-seedream-image-generate

Скилл даёт доступ к трём версиям Seedream (4.0, 4.5, 5.0-lite). Версия 4.0 быстрая, подходит для повседневной работы. Версия 4.5 богаче деталями, лучше справляется со сложными сценами. Версия 5.0-lite — самая мощная, поддерживает веб-поиск, выбор формата вывода (PNG или JPEG), даёт лучший результат для творческих проектов.

Функции включают текст-в-изображение, трансформацию стилей по эталонному изображению, пакетную генерацию до 15 изображений, управление водяными знаками, кастомные размеры. Для работы нужен API-ключ Volcano Engine: установи переменную окружения ARK_API_KEY, MODEL_IMAGE_API_KEY или MODEL_AGENT_API_KEY. По умолчанию используется версия 5.0, но можешь выбрать любую.

Вывод поддерживает форматы URL или base64. Тайм-аут запроса — 1200 секунд. Без ключа API сервер не запустится.

Какие задачи решает

  • создать иллюстрацию по текстовому описанию
  • переделать изображение в другом художественном стиле
  • сгенерировать несколько вариантов картинки за раз
  • получить изображение высокого качества для проекта
  • найти и визуализировать актуальные объекты через веб-поиск

Примеры запросов агенту

  • Нарисуй кота, играющего в саду, в стиле акварели
  • Переделай эту фотографию в аниме-стиль, используя версию 5.0
  • Сгенерируй три варианта закат над горами для дизайна обложки

Как установить byted-seedream-image-generate

1Через Skills CLI (Vercel)

npx skills add bytedance/agentkit-samples --skill byted-seedream-image-generate -a claude-code

2Вручную: положить файлы

~/.claude/skills/byted-seedream-image-generate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/byted-seedream-image-generate/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о byted-seedream-image-generate

Как установить byted-seedream-image-generate в Claude Code?

Выполни npx skills add bytedance/agentkit-samples --skill byted-seedream-image-generate -a claude-code, затем посмотри инструкцию в ~/.claude/skills/byted-seedream-image-generate/SKILL.md.

Что делает byted-seedream-image-generate?

Генерирует и трансформирует изображения с помощью моделей Seedream. Может создавать картинки из описаний, менять стиль по эталону, делать пакетную генерацию, искать объекты в интернете и переводить их в изображение (версия 5.0).

Какую версию модели выбрать?

По умолчанию 5.0-lite — самая качественная и универсальная. Выбери 4.0 для быстрой работы, 4.5 для деталей и сложных сцен. Если нужны веб-поиск или PNG — только 5.0.

Исходный текст

SKILL.md · Apache-2.0
---
name: byted-seedream-image-generate
description: Generate high-quality images from text prompts using Volcano Engine Seedream models. Supports multiple artistic styles and aspect ratios. Use this skill when users want to create images from text descriptions, generate artwork in various styles, create visual content for creative projects, or need AI-powered image generation capabilities.
license: Apache-2.0
tags: ["image-generation", "seedream", "volcengine", "ai-art", "text-to-image", "image-to-image"]
version: 1.0.0
---

# byted-seedream-image-generate

## Description

Generate high-quality images from text prompts using Volcano Engine Seedream models. This skill provides access to three powerful Seedream model versions (4.0, 4.5, and 5.0-lite), each offering unique capabilities for different use cases.

## When to Use This Skill

Use this skill when:
- Users want to create images from text descriptions
- Users need to generate artwork in various artistic styles
- Users want to create visual content for creative projects
- Users need AI-powered image generation capabilities
- Users want to convert reference images to different styles
- Users need to generate multiple images in batch
- Users require high-quality, professional-looking images

## Model Versions

| Version | Model Name | Release Date | Recommendation | Best For |
|---------|------------|--------------|----------------|----------|
| 4.0 | doubao-seedream-4-0-250828 | August 2025 | ⭐⭐⭐ | Daily use, quick generation |
| 4.5 | doubao-seedream-4-5-251128 | November 2025 | ⭐⭐⭐⭐ | Detail-oriented work, complex scenes |
| 5.0 | doubao-seedream-5-0-260128 | 2026 | ⭐⭐⭐⭐⭐ | Highest quality, best creativity, tools support |

## Features

- **Text-to-Image**: Generate images from detailed text descriptions
- **Image-to-Image**: Transform reference images into different styles
- **Batch Generation**: Create multiple images in a single request
- **Multiple Versions**: Choose from 4.0, 4.5, or 5.0-lite models
- **Watermark Control**: Option to disable watermarks
- **Custom Sizes**: Support for various image dimensions
- **Output Formats**: PNG and JPEG formats (5.0-lite only)
- **Web Search Tools**: Internet search integration (5.0-lite only)

## Installation & Setup

### Prerequisites

```bash
# Required: API Key configuration
export MODEL_IMAGE_API_KEY="your-api-key-here"
# or
export MODEL_AGENT_API_KEY="your-api-key-here"
# or
export ARK_API_KEY="your-api-key-here"

# Optional: API Base URL (default already configured)
export MODEL_IMAGE_API_BASE="https://ark.cn-beijing.volces.com/api/v3"
# or
export ARK_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"
```

The script will prioritize:
1. Environment variables (`ARK_API_KEY`, `MODEL_IMAGE_API_KEY`, `MODEL_AGENT_API_KEY`)
2. Environment variables (`ARK_BASE_URL`, `MODEL_IMAGE_API_BASE`)
3. Default values

## Usage

### Basic Usage (5.0-lite version recommended)

```bash
cd scripts
python seedream_image_generate.py -p "A cute kitten playing in a garden"
```

### Specify Version

```bash
# Use 4.0 version
python seedream_image_generate.py -p "A cute kitten" --version 4.0

# Use 4.5 version
python seedream_image_generate.py -p "A cute kitten" --version 4.5

# Use 5.0-lite version (recommended)
python seedream_image_generate.py -p "A cute kitten" --version 5.0
```

### Advanced Options

```bash
# Custom size without watermark
python seedream_image_generate.py -p "Beautiful sunset" -s 2048x2048 --no-watermark --version 5.0

# Batch generation
python seedream_image_generate.py -p "Generate 3 cute dog pictures" -g --max-images 3 --version 4.5

# Image-to-image
python seedream_image_generate.py -p "Convert this image to anime style" -i "https://example.com/image.jpg" --version 5.0

# Web search tool (5.0-lite only)
python seedream_image_generate.py -p "Latest 2026 smartphone" --web-search --version 5.0

# Custom output format (5.0-lite only)
python seedream_image_generate.py -p "A beautiful landscape" --output-format png --version 5.0

# List all supported versions
python seedream_image_generate.py --list-versions
```

## Command Line Options

| Option | Shortcut | Description | Default |
|--------|----------|-------------|---------|
| `--prompt` | `-p` | Image description text (required) | - |
| `--version` | `-v` | Version selection: `4.0`, `4.5`, `5.0` | `5.0` |
| `--size` | `-s` | Image dimensions | `2048x2048` |
| `--image` | `-i` | Single reference image URL | - |
| `--images` | - | Multiple reference image URLs (space separated) | - |
| `--group` | `-g` | Enable batch image generation | `false` |
| `--max-images` | - | Maximum images for batch generation | `15` |
| `--output-format` | - | Output format: `png` or `jpeg` (5.0 only) | `jpeg` |
| `--response-format` | - | Response format: `url` or `b64_json` | `url` |
| `--stream` | - | Enable streaming output | `false` |
| `--web-search` | - | Enable web search tool (5.0 only) | `false` |
| `--optimize-prompt-mode` | - | Prompt optimization mode: `standard` or `fast` | - |
| `--timeout` | `-t` | Timeout in seconds | `1200` |
| `--no-watermark` | - | Disable watermark | `false` |
| `--list-versions` | - | List all supported versions | - |

## Python API Usage

```python
import asyncio
import sys

sys.path.append("scripts")
from seedream_image_generate import seedream_generate

async def main():
    # Use 5.0-lite version (default)
    result = await seedream_generate([
        {
            "prompt": "A cute kitten",
            "size": "2048x2048",
            "watermark": False,
            "output_format": "png"  # 5.0-lite only
        }
    ], version="5.0")
    
    print(result)

asyncio.run(main())
```

## Version Selection Guide

### Choose 4.0 if:
- You need quick daily generation
- Quality requirements are not extremely high
- You need faster generation speed
- Simple scenes and styles

### Choose 4.5 if:
- You want richer details
- You're working with complex scenes
- You need better style reproduction
- You have moderate quality requirements

### Choose 5.0-lite (Recommended) if:
- You want the highest quality
- You need breakthrough creative expression
- You have extreme detail requirements
- **You need tools parameter (like web search)** ⭐
- **You need custom output format (png/jpeg)** ⭐
- Important projects and work

**When in doubt, use 5.0-lite!** ⭐

## Prompt Engineering Tips

### Basic Prompt Structure
```
[Subject Description] + [Style/Art Movement] + [Lighting/Atmosphere] + [Quality/Resolution]
```

### Advanced Prompts (Optimized for 5.0-lite)
```
[Subject Description], [Creative Style/Art Movement], [Unique Perspective/Composition], [Special Lighting/Atmosphere], [Emphasizing 5.0-lite creative expression]
```

## Parameter Support by Version

| Parameter | Seedream 4.0 | Seedream 4.5 | Seedream 5.0-lite | Description |
|-----------|--------------|--------------|-------------------|-------------|
| model | ✅ | ✅ | ✅ | Model name |
| prompt | ✅ | ✅ | ✅ | Prompt (required) |
| image | ✅ | ✅ | ✅ | Reference image(s) |
| size | ✅ | ✅ | ✅ | Image dimensions |
| sequential_image_generation | ✅ | ✅ | ✅ | Batch generation control |
| sequential_image_generation_options | ✅ | ✅ | ✅ | Batch generation config |
| response_format | ✅ | ✅ | ✅ | Response format (url/b64_json) |
| watermark | ✅ | ✅ | ✅ | Watermark (true/false) |
| stream | ✅ | ✅ | ✅ | Streaming output |
| optimize_prompt_options | ✅ | ✅ | ✅ | Prompt optimization config |
| **tools** | ❌ | ❌ | **✅** | Tool configuration (5.0-lite only) |
| **output_format** | ❌ | ❌ | **✅** | Output format (png/jpeg, 5.0-lite only) |


## Final Return Info

### For OpenClaw
1. **First, save/download the generated image to an allowed directory**:
   - Recommended: `~/.openclaw/workspace/`

2. **Use the `message tool` to send the image** with these parameters:
   ```json
   {
     "action": "send",
     "message": "Optional text description",
     "media": "/root/.openclaw/workspace/generated-image.jpg"
   }
   ```
   - The tool will automatically: read the local file, upload to the channel server as a web URL, and send as an image message

3. **Verify success**: Check that the tool returns `{"ok": true}` to confirm the image was sent successfully

4. **Normal Text** not message tool: After generation, show list of images with Markdown format, for example:
      ![generated-image-1](https://example.com/image1.png)
    **Very important**:
    The image URL must be an **original online resource link** starting with `https://`, **not** a local image address you have downloaded.

### For Normal
You should return three types of information:
1. File format, return the image file (if you have some other methods to send the image file) and the local path of the image, for example:
local_path: /root/.openclaw/workspace/skills/image-generate/xxx.png
2. After generation, show list of images with Markdown format, for example:
```
      ![generated-image-1](https://example.com/image1.png)
      ![generated-image-2](https://example.com/image2.png)
```

## FAQ

### Q: What's the difference between the versions?
A: 4.0 is for quick daily use, 4.5 offers better details for complex scenes, and 5.0-lite provides the highest quality with unique tools support.

### Q: How long are generated URLs valid?
A: URLs are valid for 24 hours. Please download and save your images promptly.

### Q: What image formats are supported for references?
A: Common formats like JPG and PNG are supported, provided via URL or Base64.

### Q: Can I use multiple versions in one call?
A: Currently, only one version per call. For comparisons, make separate calls for different versions.

## License

This skill is licensed under the Apache License 2.0. See the LICENSE file for details.

## Notice

Please comply with Volcano Engine's terms of service and relevant laws and regulations when using this skill.

© bytedance · Apache-2.0 · bytedance/agentkit-samples

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
jimeng-api-image-gen wvlvik Скилл jimeng-api-image-gen для Claude Code, Codex, Cursor и других платформ генерирует изображения через Volcengine Jimeng API 4.0. Включается при запросах «создай картинку», «нарисуй» или упоминании Jimeng. CX Codex +1 503установок bytedance-seedream calesthio Скилл bytedance-seedream для Claude Code генерирует и редактирует изображения через Ark. Подключается к задачам с референсами, группами результатов и потоковой выдачей. CX Codex +1 136установок seedream-image acedatacloud Скилл seedream-image для Claude Code подключает Seedream 5.0 для генерации, редактирования и разложения изображений на слои. Обрабатывает референсы, создаёт изображения с прозрачным фоном и серии картинок. CX Codex +1 235установок generate-image K-Dense-AI Скилл generate-image для Claude Code генерирует и редактирует изображения через OpenRouter Image API в моделях Gemini, Recraft и Seedream. Создаёт иллюстрации, логотипы и концепт-арт. CX Codex +1 2 200установок scenario-seedream scenario-labs Скилл scenario-seedream подключает модели Seedream от ByteDance через Scenario MCP для генерации, редактирования и нарезки изображений на слои прямо в чате с агентом. CX Codex +1 843установок image-generation claude-office-skills Скилл image-generation для Claude Code составляет промпты для DALL-E, Midjourney и Stable Diffusion. Он подключается к задачам генерации изображения в заданном стиле или формате. CX Codex +1 5 800установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой