seedream_edit_image
Edit images by providing text instructions to change styles, backgrounds, or attributes. Use cases include style transfer, background replacement, 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 |
|---|---|---|---|
| seed | No | Random seed for reproducible edits. Range: [-1, 2147483647]. Default is -1 (random). Only works with v3 models. | |
| size | No | Output image resolution. '1K' (default), '2K', '3K', '4K', or 'adaptive'. | |
| 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. 'doubao-seededit-3-0-i2i-250628' (dedicated editing model, best for image modification). Other models can also be used for editing when images are provided. | doubao-seededit-3-0-i2i-250628 |
| 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'. | |
| guidance_scale | No | Prompt weight — higher values make edits follow the prompt more closely. Range: [1, 10]. Default is 5.5 for doubao-seededit-3-0-i2i. Only works with v3 models. | |
| response_format | No | Response format. 'url' (default) or 'b64_json'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |