Generate a Seedream image
seedream_generate_imageDestructive
Generate original AI images from text prompts with ByteDance Seedream models, including photos, illustrations, and art in custom styles. Use it to create new images, not edit existing ones.
Instructions
Generate an AI image from a text prompt using ByteDance's Seedream model.
This tool creates high-quality images from text descriptions using ByteDance's
Seedream models (powered by Doubao). Supports multiple model versions with different
capabilities and quality levels.
Use this when:
- You want to generate a new image from scratch based on a text description
- You need high-quality AI-generated images (photos, illustrations, art)
- You want to create images with specific styles, compositions, or themes
Do NOT use this when:
- You want to edit or modify an existing image (use seedream_edit_image instead)
- You need to combine multiple images (use seedream_edit_image instead)
Model selection guide:
- v5.0 Lite (doubao-seedream-5-0-lite-260128): Image sets, streaming, and web search
- v4.5 (doubao-seedream-4-5-251128): Previous flagship, great quality and detail
- v4.0 (doubao-seedream-4-0-250828): Stable and cost-effective, great for most tasks
Returns:
JSON with task_id, trace_id, success status, and generated image data
including image URLs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Model-specific output size: Pro supports 1K/1.5K/2K (and auto for decomposition); Lite supports 2K/3K/4K. Explicit dimensions such as 2048x1024 are also accepted. | |
| model | No | Model to use for generation. 'doubao-seedream-5-0-pro-260628' (v5.0 Pro, flagship single image, highest quality; no sequential generation, streaming, or web search). 'doubao-seedream-5-0-lite-260128' (v5.0 Lite, sequential generation, streaming, web search). 'doubao-seedream-4-5-251128' (v4.5, previous flagship, great quality). 'doubao-seedream-4-0-250828' (v4.0, stable, best value). | doubao-seedream-5-0-lite-260128 |
| tools | No | Optional list of tool types for the model to use during generation. Currently only 'web_search' is supported. Only supported by doubao-seedream-5-0-lite-260128 (v5.0 Lite). | |
| prompt | Yes | Description of the image to generate. Be descriptive about subject, style, atmosphere, lighting, and composition. Supports both Chinese and English. Example: 'A photorealistic portrait of an astronaut on Mars, golden hour lighting, cinematic composition, ultra-detailed' | |
| watermark | No | Whether to add an AI-generated watermark. Default is true. | |
| callback_url | No | Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete. Must be publicly accessible. | |
| output_format | No | Output image format. 'jpeg' (default) or 'png'. | |
| response_format | No | Response format for the generated image. 'url' (default) returns a public image URL. 'b64_json' returns base64-encoded image data. | |
| optimize_prompt_options | No | Optional prompt optimization configuration. Supports `mode` with values 'standard' (higher quality, slower) or 'fast' (quicker, lower quality). Seedream 5.0 Pro and 4.0 support standard/fast; 5.0 Lite and 4.5 support standard only. | |
| sequential_image_generation | No | Generate related images based on input. 'auto' enables it, 'disabled' (default) turns it off. Supported by Seedream 5.0 Lite, 4.5, and 4.0; not Pro. | |
| sequential_image_generation_options | No | Tunable options for grouped image generation. Only honored when `sequential_image_generation=auto`. Supports `max_images` (int, range [1, 15]). Supported by Seedream 5.0 Lite, 4.5, and 4.0; not Pro. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |