byted-seedream-image-generate

Description

When to Use This Skill

• 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

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

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

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)

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

Specify Version

# 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

# 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

--prompt

-p

--version

-v

4.0

4.5

5.0

5.0

--size

-s

2048x2048

--image

-i

--images

--group

-g

false

--max-images

15

--output-format

png

jpeg

jpeg

--response-format

url

b64_json

url

--stream

false

--web-search

false

--optimize-prompt-mode

standard

fast

--timeout

-t

1200

--no-watermark

false

--list-versions

Python API Usage

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

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

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： 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

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?

Q: How long are generated URLs valid?

Q: What image formats are supported for references?

Q: Can I use multiple versions in one call?

License

Notice