byted-seedream-image-generate

Files (3)

• LICENSE
• SKILL.md
• seedream_image_generate.py · scripts/

SKILL.md (first lines)

# 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` | - |

From bytedance/agentkit-samples, Apache-2.0.

More from bytedance/agentkit-samples