seedream_generate_image
Generate images from text descriptions using AI. Supports multiple Seedream models, resolutions up to 4K, and streaming options.
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 (doubao-seedream-5-0-260128): Latest flagship, highest quality
- 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
- v3 T2I (doubao-seedream-3-0-t2i-250415): Supports seed for reproducibility
Returns:
JSON with task_id, trace_id, success status, and generated image data
including image URLs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Random seed for reproducible results. Range: [-1, 2147483647]. Default is -1 (random). Only works with v3 models (doubao-seedream-3-0-t2i and doubao-seededit-3-0-i2i). | |
| size | No | Output image resolution. '1K' (default), '2K', '3K', '4K', or 'adaptive'. You can also specify custom dimensions like '1024x1024', '1280x720', etc. | |
| 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-260128' (v5.0 Lite, latest flagship, 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-3-0-t2i-250415' (v3 text-to-image, supports seed and guidance_scale). 'doubao-seededit-3-0-i2i-250628' is for image editing only — use seedream_edit_image instead. | doubao-seedream-5-0-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-260128 (v5.0). | |
| 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' | |
| stream | No | Stream all pictures progressively. Default is false. Only supports v4.5 and v4.0 models. | |
| 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'. | |
| guidance_scale | No | Prompt weight — higher values make the result more closely follow the prompt. Range: [1, 10]. Default is 2.5 for doubao-seedream-3-0-t2i. Only works with v3 models. | |
| 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). Only supported on doubao-seedream-4.5 (standard mode only) and doubao-seedream-4.0. | |
| sequential_image_generation | No | Generate related images based on input. 'auto' enables it, 'disabled' (default) turns it off. Only supports v4.5 and v4.0 models. | |
| 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]). Only supported on doubao-seedream-4.5 and doubao-seedream-4.0. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |