Blend Multiple Images
seedream_blendCombine elements from 2-14 reference images by describing what to take from each, enabling virtual try-on, face swaps, style transfer, and product placement.
Instructions
Combine elements from multiple images using SeeDream 4.5.
⚠️ CLAUDE.AI USERS: This tool WILL TIMEOUT on Claude.ai (takes 30-60 seconds). Use "seedream_submit" instead with mode="multi" for Claude.ai compatibility.
Use this tool to blend 2-14 reference images together. Perfect for:
Virtual try-on: Dress person from image 1 in clothes from image 2
Face/Subject swap: Put face/subject from image 1 onto body/scene in image 2
Style transfer: Apply style of image 2 to content of image 1
Product visualization: Put product from image 1 into scene from image 2
Character consistency: Combine character traits from multiple references
Args:
prompt (string, required): Blending instruction referencing images by number
images (string[], required): Array of 2-14 image URLs or local paths
size (string): Output size (default: '2K')
strength (number): Reference strength 0-1 (default: 0.7)
watermark (boolean): Add watermark (default: false)
download (boolean): Save locally (default: true)
download_dir (string): Local save directory
Returns: Blended image URL, local path if downloaded, and performance timing.
Prompt Structure (per official docs):
Reference Target: Clearly specify what to extract from each reference image
Scene Description: Describe the output scene layout and composition
Always reference images by number: "image 1", "image 2", etc.
Common Use Cases:
Virtual try-on: "Dress the character in Image 1 with the outfit from Image 2"
Subject replacement: "Replace the subject in Image 1 with the subject from Image 2"
Style transfer: "Apply the style of Image 2 to Image 1"
Product placement: "Place the product from Image 1 on the table in Image 2"
Examples:
"Replace the clothing in image 1 with the outfit from image 2"
"Put the face from image 1 onto the body in image 2, maintaining natural lighting"
"Apply the linear minimalist style of image 2 to design icons based on image 1"
"Generate four tops in different materials, based on the clothing style worn by the girl in the reference images"
Tips:
Be specific about which elements to take from each image
For best results, use similar aspect ratios for inputs
Higher strength preserves more details from reference images
Using 10+ reference images significantly impacts generation speed
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Output image size | 2K |
| images | Yes | Array of image URLs or local file paths to blend | |
| prompt | Yes | Instruction for combining images. Reference images by number: 'Dress the person in image 1 with outfit from image 2' | |
| download | No | Whether to download generated images to local directory | |
| strength | No | Reference strength (0-1). Higher values preserve more from reference images. | |
| watermark | No | Whether to add 'AI generated' watermark | |
| 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 | |
| strength | Yes | The strength value used for blending | |
| image_count | Yes | Number of images blended | |
| source_images | Yes | Array of source images used |