SeedEdit_v3.0 (Image Command Editing)

POST

/doubao/drawing/seededit_v30

Image Generation Model from Doubao
Instruction Editing SeedEdit 3.0 is an image editing model independently developed by ByteDance. It is a diffusion model capable of modifying a given image using text prompts. The model has made significant progress in accurately following editing instructions and effectively preserving image content (such as character features and fine details), especially excelling when processing real images. It achieves an excellent balance among multiple key editing metrics and can produce high-quality editing results that effectively meet user expectations.

SeedEdit 3.0 was compared with SeedEdit 1.6, GPT-4o, and Gemini 2.0 on an internal real image testing benchmark. The results show that SeedEdit 3.0 achieves an excellent balance and satisfactory scores among all these models.

Introduction: https://www.volcengine.com/docs/85128/1602254#qjPoVNsm

Price: 0.05 PTC/time

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

binary_data_base64

array[string]

required

Image file, base64 encoded. You need to input either one image or one url, choose one of the two. When using one, the other needs to be commented out; do not pass the corresponding field, otherwise an error will occur.

image_urls

array[string]

required

Image file URL. You need to provide either one image or base64, choose one of the two. If you use one, the other must be commented out. Do not submit both fields, otherwise an error will occur.

prompt

string

required

Prompt words for editing images. Suggestions:
Length <= 700 characters
Use natural language for editing instructions
It’s better to use a single instruction for each edit
For local edits, make the instruction as precise as possible, especially when there are multiple entities in the image—clearly describe what to do to whom for more accurate editing results
If the editing effect is not obvious, try adjusting the editing strength scale; the higher the value, the closer it follows the instruction
Try to use clear, high-resolution base images; images generated by the Doubao model will have better editing results.

Reference examples:
Add/Delete entity: Add/Delete xxx (Delete the girl in the picture / Add a rainbow)
Modify entity: Change xxx to xxx (Change the chicken leg in the hand to a hamburger)
Change style: Change to xxx style (Change to comic style)
Change color: Change xxx to xx color (Change the clothes to pink)
Change action: Modify expression or action (Make him cry/laugh/angry)
Change environment/background: Change the background to xxx, at xxx (Change the background to the seaside / Under the starry sky)

seed

integer

required

Random seed, used as the basis for determining the initial state of diffusion. Default is -1 (random). If the random seed is the same positive integer and all other parameters are identical, the generated content will most likely be consistent.
Default value: -1

scale

number

required

The degree of influence of the text description. The larger the value, the greater the influence of the text description, and the smaller the influence of the input image.
Default value: 0.5
Value range: [0, 1]

Example

{
    // "binary_data_base64": [],
    "image_urls": [
        "https://file.302.ai/gpt/imgs/20250703/b67c97c8291640b79a1e1bbd74b41ff5.jpeg"
    ],
    "prompt": "背景换成演唱会现场",
    "seed": -1,
    "scale": 0.5
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/doubao/drawing/seededit_v30' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    // "binary_data_base64": [],
    "image_urls": [
        "https://file.302.ai/gpt/imgs/20250703/b67c97c8291640b79a1e1bbd74b41ff5.jpeg"
    ],
    "prompt": "背景换成演唱会现场",
    "seed": -1,
    "scale": 0.5
}'

Responses

🟢200成功

application/json

Body

code

integer

required

data

object

required

task_id

string

required

message

string

required

request_id

string

required

status

integer

required

time_elapsed

string

required

Example

{
    "code": 10000,
    "data": {
        "task_id": "13255822150128211173"
    },
    "message": "Success",
    "request_id": "20250704110639B45733F15D31C41ACBCD",
    "status": 10000,
    "time_elapsed": "1.087912558s"
}

Modified at 2025-07-07 05:39:11

Character（Character Feature Preservation）

SeedEdit_v3.0 (Result Acquisition)