Generate Image Variations
seedream_variationsGenerate 2 to 15 coherent image variations from a prompt or base image for A/B testing, storyboards, product variations, and social media content.
Instructions
Generate multiple variations of an image concept using SeeDream 4.5.
⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 30-90 seconds). Use "seedream_submit" instead for Claude.ai compatibility.
Use this tool to create 2-15 coherent variations based on a prompt. Great for:
A/B testing: Generate multiple options to compare
Storyboards: Create a series of related images
Product variations: Same product in different colors/styles
Exploration: See different interpretations of your concept
Social media: Multiple posts from one concept
Args:
prompt (string, required): Base concept for generating variations. Include batch keywords like "a series", "a set", "Generate X images" for best results.
count (number): Number of variations to generate (2-15, default: 4)
base_image (string, optional): Reference image to create variations from
size (string): Output size (default: '2K')
watermark (boolean): Add watermark (default: false)
download (boolean): Save locally (default: true)
download_dir (string): Local save directory
Returns: Array of variation image URLs, local paths if downloaded, and performance timing.
Prompt Best Practices (per official docs):
Include batch keywords: "a series of", "a set of", "Generate X images"
Describe variations explicitly: "4 seasonal versions", "different color schemes"
For storyboards: describe each panel's content in sequence
Keep prompts under 600 English words for best results
Examples:
"Generate a series of 4 seasonal variations of a cozy coffee shop interior"
"Create a set of 6 color variations of this minimalist logo design"
"Generate 4 different poses of this anime character in action"
"Create a 4-panel storyboard: morning coffee, commute, work, evening relaxation"
Tips:
The model maintains consistency across variations automatically
Use count=4 for quick comparisons, higher for more options
Adding a base_image helps maintain visual consistency
Note: base_image cannot be combined with batch generation (API limitation)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Output image size | 2K |
| count | No | Number of variations to generate (2-15) | |
| prompt | Yes | Base prompt for generating variations. The model will create coherent variations based on this. | |
| download | No | Whether to download generated images to local directory | |
| watermark | No | Whether to add 'AI generated' watermark | |
| base_image | No | Optional base image to create variations from | |
| download_dir | No | Local directory to save images (defaults to ./generated_images) | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for structured data | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usage | No | API usage metrics | |
| images | Yes | Array of generated images | |
| prompt | Yes | The prompt used for generation | |
| timing | No | Performance timing metrics | |
| success | Yes | Whether the generation was successful | |
| base_image | No | Base image used for variations | |
| generated_count | Yes | Number of variations actually generated | |
| requested_count | Yes | Number of variations requested |