seedream_edit_image
Modify existing images via text instructions to change style, background, attributes, or clothing. Handles single or multiple images for style transfer, scene changes, and virtual try-on.
Instructions
Edit or modify existing images using ByteDance's Seedream/SeedEdit model.
This tool modifies existing images based on text instructions. It can change
styles, backgrounds, attributes, clothing, and more. Supports single or
multiple image inputs.
Use this when:
- You want to modify or transform an existing image
- You need to change style, background, colors, or attributes
- You want to apply artistic transformations (watercolor, oil painting, etc.)
- You need virtual try-on (clothing on person)
- You want to place objects in different scenes
Common use cases:
- Style transfer: "Convert to anime style", "Make it look like a pencil sketch"
- Background change: "Replace background with a sunset beach"
- Attribute edit: "Change hair color to blonde", "Add sunglasses"
- Virtual try-on: Provide person image + clothing image
- Scene composition: Place products in realistic environments
Returns:
JSON with task_id, trace_id, success status, and edited image data
including image URLs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Output image resolution. '1K' (default), '2K', '3K', or '4K'. | |
| image | Yes | List of image URLs or base64-encoded images to edit. Supports HTTP/HTTPS URLs (publicly accessible) or base64 format (data:image/png;base64,...). Each image must be under 10MB. | |
| model | No | Model to use for editing. Seedream 5.0 Pro, 5.0 Lite, 4.5, and 4.0 all support image editing when images are provided. | doubao-seedream-5-0-260128 |
| prompt | Yes | Description of the edit to perform on the image(s). Describe what changes you want. Example: 'Change the background to a beach scene', 'Make the person wear a red dress', 'Convert to watercolor painting style' | |
| watermark | No | Whether to add an AI-generated watermark. Default is true. | |
| callback_url | No | Optional webhook URL for async result notification. | |
| output_format | No | Output image format. 'jpeg' (default) or 'png'. | |
| response_format | No | Response format. 'url' (default) or 'b64_json'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |