doubao-image-generation

name	doubao-image-generation
description	Volcano Engine Doubao Seedream image generation API integration. Supports text-to-image, image-to-image, sequential image generation, and multi-image fusion. Use when you need to generate images via Doubao Seedream API.

Doubao Seedream Image Generation Skill

Configuration

Before use:

1. Create a .env file in the project root directory:

   DOUBBAO_API_KEY=your_api_key_here
   DOUBBAO_API_BASE=https://api.cozex.cn/v1/images/generations
   

2. Or copy from .env.example:

   cp .env.example .env
   # Edit .env and add your API key
   

The script will automatically load configuration from the .env file.

Usage

Call the Python script to generate images:

python scripts/generate-image.py --prompt "your prompt here" [options]

Options:

• --model: Model name (default: doubao-seedream-5-0-260128) Available models:
  • doubao-seedream-4-0-250828 - Basic version
  • doubao-seedream-4-5-251128 - Enhanced version
  • doubao-seedream-5-0-260128 - Latest version (better complex prompt understanding)
• --prompt: Text description of the image (required)
• --size: Image size, default 2K, options: 4K or custom like 2048x2048. See references/api-reference.md for recommended aspect ratios.
• --images: Comma-separated list of input image URLs (for image-to-image or multi-image fusion)
• max-images: Maximum number of images to generate for sequential group generation (1-15, default 1)
• --watermark: Add watermark, default false
• --output: Output file to save result JSON

Modes

1. Text-to-image: Just provide a prompt
2. Image-to-image: Provide prompt + one input image URL
3. Multi-image fusion: Provide prompt + multiple input image URLs
4. Sequential group generation: Enable sequential mode to generate multiple related images

Full API documentation: references/api-reference.md