Doubao Seedream Plugin for Dify
English | Simplified Chinese

A Dify plugin that integrates Volcengine's Doubao Seedream V4.5, Seedream 5.0-lite, and Seedream 5.0-pro models, providing high-quality AI image generation capabilities.
Latest Updates
v1.1.1 - 2026-07-15
v1.1.0 — 2026-07-10
- Added the ImageGenerations (5.0-pro) tool using model
doubao-seedream-5-0-pro-260628.
- Added text-to-single-image, single-reference editing, and multi-reference generation with up to 10 input images.
- Added 1K/2K resolution tiers, official aspect-ratio presets, custom dimensions, and PNG/JPEG output.
See the full changelog for the complete release history.
Features
- Text-to-Image: Generate high-definition images from text descriptions.
- Image-to-Image: Create new images based on a reference image and a prompt.
- Batch Generation: Support for generating multiple coherent images (up to 15) in one request.
- Flexible Customization: Support for model-specific resolution presets and customizable aspect ratios.
- High-precision Generation: Seedream 5.0-pro supports single-image generation and editing with up to 10 reference images.
- Watermark Control: Option to toggle watermarks on generated images.
Available Tools
| Dify Tool | Model ID | Main Capabilities | Plugin Size Options | Output Formats |
|---|
| ImageGenerations (4.5) | doubao-seedream-4-5-251128 | Text-to-image, image-to-image, group generation | 2K, 4K, custom | JPEG |
| ImageGenerations (5.0-lite) | doubao-seedream-5-0-260128 | Text/image generation, group generation, web search | 2K, 3K, custom | JPEG, PNG |
| ImageGenerations (5.0-pro) | doubao-seedream-5-0-pro-260628 | High-precision text-to-single-image and reference-based generation | 1K, 2K, custom | JPEG, PNG |
Parameter Highlights
- prompt: Text prompt to generate an image (Supports Chinese and English).
- sequential_image_generation: Set to True for generating a group of related images (up to 15).
- image: Reference image(s) for Image-to-Image tasks.
- size: Multiple presets (V4.5: 2K/4K; 5.0-lite: 2K/3K; 5.0-pro: 1K/2K), aspect-ratio presets, or customize for specific dimensions.
- width/height: Required when size is set to customize. For 5.0-pro, total pixels must be in [921,600, 4,624,220], with an aspect ratio between 1/16 and 16.
- watermark: Whether to add a watermark to the generated images (Default: False).
- output_format (5.0-lite/5.0-pro): Output image format, jpeg or png (Default: jpeg).
- web_search (5.0-lite): Enable web search tool (the model decides whether to search).
Seedream 5.0-pro always returns a single image and does not support group generation, web search, or streaming output.
Installation
For Dify Users
To use this plugin, you need to configure the following credentials in the Dify plugin settings:
- Go to Plugins in your Dify dashboard.
- Click on Install from GitHub or upload the plugin package.
- Ark API Key: Your API key obtained from the Volcengine Ark Console.
- Ark Base URL: The default is
https://ark.cn-beijing.volces.com/api/v3.
For Developers
If you want to modify the plugin, ensure you have the following dependencies:
pip install -r requirements.txt
Important Notes
- Image Expiry: Generated image URLs are typically valid for 24 hours.
- Dimension Constraints: For custom sizes, the aspect ratio must be between 1/16 and 16.
License
This project is licensed under the terms specified in PRIVACY.md.