Seedream 5.0 Pro Edit

Name: ByteDance Seedream 5.0 Pro Edit
Price: 0.09 USD
Availability: InStock
Author: ByteDance

bytedance/seedream/5.0/pro/edit

Seedream 5.0 Pro is Bytedance's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Try the model

Playground

Open playground

Input

Prompt(string)

The text prompt used to edit the image.

Image URLs(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 10

List of URLs of input reference images. Up to 10 images are supported; if more are sent, only the last 10 are used.

Add at least one media item.

Additional Settings More

Customize your input with more control.

Aspect Ratio(string)

The aspect ratio of the edited 2K image. Leave unset to follow the reference image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Number of Images(integer)

The number of edited images to generate. Currently limited to 1. Range: 1 to 1.

Output Format(string)

The file format of the generated image. Allowed values: jpeg, png.

Result

Example

What would you like to do next?
Open original

Examples

Select an example to load its inputs and result into the playground.

Input

{
  "images": [
    "https://static.sandbase.ai/examples/a41b72ba-8748-49c4-9eca-e1a1d1566e86/input/83baa511-b454-4c5e-b799-66cf7a0c47fb.png",
    "https://static.sandbase.ai/examples/a41b72ba-8748-49c4-9eca-e1a1d1566e86/input/e8207f7d-83ad-4d7d-a340-cd3c53a00319.png",
    "https://static.sandbase.ai/examples/a41b72ba-8748-49c4-9eca-e1a1d1566e86/input/9bf41b90-b1b3-4b70-98cc-5616f8c52af1.png"
  ],
  "prompt": "Replace the product in Figure 1 with that in Figure 2. Seamlessly render the logo in Figure 3 into the product design, in a frosted glass texture."
}

Open result ↗

Human preference

Arena

Elo ratings from blind side-by-side votes, compared with other image and video models.

Rankings sourced from Artificial Analysis Arena

Leaderboard: Image Editing
Rank: #9 of 77
Elo: 1131 ±13
Gap to #1: −68

Image-editing arena: people pick the better of two edits of the same image and instruction, without seeing the model names.

#4Krea 3 (Ultra)Krea1151±14
#5MAI-Image-2.6Microsoft AI1151±12
#6Nano Banana 2.1Google1151±13
#7MAI-Image-2.6-FlashMicrosoft AI1144±13
#8GPT Image 2 (high)OpenAIOn SandBase1136±13
#9Seedream 5.0 ProByteDance SeedThis model1131±13
#10Muse ImageMeta1129±12
#11MAI-Image-2.5Microsoft AIOn SandBase1127±13
#12Krea 3 (Fast)Krea1126±14
#13MAI-Image-2.5-ProMicrosoft AIOn SandBase1123±12

Seedream 5.0 Pro Edit

Seedream 5.0 Pro edit: change or fuse up to 10 images with an instruction while keeping identity, products, and text consistent.

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Text instruction.
`images`	image URL[] (≤10), required	—	Images to edit or combine, Image 1, Image 2, …
`aspect_ratio`	`21:9` / `16:9` / `3:2` / `4:3` / `5:4` / `1:1` / `4:5` / `3:4` / `2:3` / `9:16`	—	Omit to follow the first input image.
`num_images`	integer 1–1	1	Fixed at 1.
`output_format`	`jpeg` / `png`	`jpeg`	Output file format.

Billing

$0.09 per output image plus $0.003 for each input image after the first.

Inputs	Price
1 input image	$0.09
3 input images	$0.096
10 input images	$0.117

Failed runs are not charged.

Prompting

Say which image is the base and what each other image contributes.
List what must not change.

Limits

One output image per request.

Also on SandBase

Other Seedream endpoints: bytedance/seedream/5.0/pro, bytedance/seedream/5.0/lite, bytedance/seedream/5.0/lite/edit, bytedance/seedream/5.0/flash, bytedance/seedream/5.0/flash/edit, bytedance/seedream/4.5, bytedance/seedream/4.5/edit.

Start building

Send your first request

Submit this model through the SandBase Unified Run API.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

bytedance/seedream/5.0/pro/edit

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "bytedance/seedream/5.0/pro/edit",
  "images": [
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_0.png",
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_1.png",
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_2.png"
  ],
  "prompt": "Replace the product in Figure 1 with that in Figure 2. Seamlessly render the logo in Figure 3 into the product design, in a frosted glass texture.",
  "num_images": 1,
  "output_format": "jpeg"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

2. Authentication

Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep the key on your server. Do not expose it in browser code or commit it to a repository.

3. Queue

Submit a request

POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.

Fetch request status and result

Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.

Poll run status

curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

4. Files

Hosted files

Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.

Uploading images

Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.

5. Schema

Input

`images`arrayrequired

List of URLs of input reference images. Up to 10 images are supported; if more are sent, only the last 10 are used.

`prompt`stringrequired

The text prompt used to edit the image.

`num_images`integer

The number of edited images to generate. Currently limited to 1.

Default: 1

Minimum: 1

Maximum: 1

`aspect_ratio`string

The aspect ratio of the edited 2K image. Leave unset to follow the reference image.

Possible values: "21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16"

`output_format`string

The file format of the generated image.

Default: "jpeg"

Possible values: "jpeg", "png"

Request body

{
  "model": "bytedance/seedream/5.0/pro/edit",
  "images": [
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_0.png",
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_1.png",
    "https://static.sandbase.ai/examples/bytedance/seedream/5.0/pro/edit/input_images_2.png"
  ],
  "prompt": "Replace the product in Figure 1 with that in Figure 2. Seamlessly render the logo in Figure 3 into the product design, in a frosted glass texture.",
  "num_images": 1,
  "output_format": "jpeg"
}

Output

A completed run exposes its result in output. The following is the model’s saved example, not a new generation.

Example output JSON

[
  {
    "source": "ByteDance/Volcengine schema mirror",
    "source_url": "https://docs.volcengine.com/docs/ark/seedance-2-0",
    "url": "https://static.sandbase.ai/examples/a41b72ba-8748-49c4-9eca-e1a1d1566e86/output/d2d69592-39c3-463f-accc-a338272a97b9.png"
  }
]

Seedream 5.0 Pro Edit

Playground

Examples

Arena

Seedream 5.0 Pro Edit

Fields

Billing

Prompting

Limits

Also on SandBase

Send your first request

2. Authentication

3. Queue

Submit a request

Fetch request status and result

4. Files

Hosted files

Uploading images

5. Schema

Input

imagesarrayrequired

promptstringrequired

num_imagesinteger

aspect_ratiostring

output_formatstring

Output

Seedream 4.5 Edit ↗

Seedream 5.0 Flash Edit ↗

Seedream 5.0 Lite Edit ↗

SeedVR2 Image Upscale ↗

Seedream 4.5 Text to Image ↗

Seedream 5.0 Flash Text to Image ↗

`images`arrayrequired

`prompt`stringrequired

`num_images`integer

`aspect_ratio`string

`output_format`string