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

CODEBLOCK0

The script will prioritize:

1. 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)

CODEBLOCK1

Specify Version

CODEBLOCK2

Advanced Options

CODEBLOCK3

Command Line Options

Option	Shortcut	Description	Default
INLINECODE5	INLINECODE6	Image description text (required)	-
INLINECODE7

-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

CODEBLOCK4

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

CODEBLOCK5

Advanced Prompts (Optimized for 5.0-lite)

CODEBLOCK6

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 | | sequentialimagegeneration | ✅ | ✅ | ✅ | Batch generation control | | sequentialimagegeneration_options | ✅ | ✅ | ✅ | Batch generation config | | responseformat | ✅ | ✅ | ✅ | Response format (url/b64json) | | watermark | ✅ | ✅ | ✅ | Watermark (true/false) | | stream | ✅ | ✅ | ✅ | Streaming output | | optimizepromptoptions | ✅ | ✅ | ✅ | Prompt optimization config | | tools | ❌ | ❌ | ✅ | Tool configuration (5.0-lite only) | | output_format | ❌ | ❌ | ✅ | Output format (png/jpeg, 5.0-lite only) |

Final Return Info

You should return three types of information:

1. 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

1. 2. After generation， show list of images with Markdown format, for example：

CODEBLOCK7

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.