WaveSpeedAI APIBytedanceBytedance Seedream V4 Edit

Bytedance Seedream V4 Edit

Bytedance Seedream V4 Edit

Playground

Try it on WavespeedAI!

Seedream 4.0 is a state-of-art image model by Bytedance. Seedream 4.0: Surpassing Nano Banana in every aspect.

Features

bytedance/seedream-v4/edit

Seedream 4.0/Edit is a specialized image-to-image model for accurate edits to existing images - swap outfits and accessories, adjust hair or makeup, recolor or re-materialize products, and replace interior finishes like floors, walls, or furniture while maintaining subject identity, lighting, and overall composition.

Highlights

  • High fidelity on people & products: Reliable skin tones, fabric/material details, logos, and fine edges.
  • Production-friendly consistency: Generate multiple variants quickly with locked camera/look and brand color grading.
  • Structured prompts that scale: Works best when the goal is clear up front (action + object + target feature + constraints).

Use cases

  • Portrait & influencer workflows: Outfit/makeup/hair changes, branded KV series, quick campaign variants.
  • E-commerce & product teams: Colorways, material/texture swaps, packaging updates.
  • Interior/archviz: Wall/floor finish replacements, upholstery changes, lighting-aware set dressing.
  • Marketing & growth: Fast A/B testing with consistent brand color and camera setup.

Price

Only $0.027 per image!!!

How to use

  1. Prepare source: Upload the base images (Up to 10 images).
  2. Set size: The maximum size of the image is 4096 * 4096.
  3. Write a clear prompt: Write clearly in the prompt about object, feature, and constraints.

Prompt patterns (copy-ready)

Use: change action + change object + target feature + constraints (keep/avoid)

Portrait (KV series)

portrait KV series, {STYLE} style, consistent color grading {BRAND_COLOR}, fixed camera look (85mm shallow depth), interchangeable persona: {PERSONA}, reserved lower-third text “{NAME} — {ROLE}”

Change Clothes / Jewellery / Makeup

Outfit swap for portrait, replace clothing with {OUTFIT_DESC}; keep pose and composition; accessories {JEWELRY_DESC}; makeup/hair {MAKEUP_HAIR}; preserve skin tone and lighting; clean edges, no artifacts

Background Replacement

Background replacement for subject, keep subject edges; new environment: {SCENE_DESC}; match light direction and color temperature; soft contact shadows; no haloing

Interior / Outdoor Replacement

Interior finish swap, update wall {WALL_MATERIAL}, floor {FLOOR_MATERIAL}, furniture upholstery {FABRIC}; layout and lighting unchanged; realistic PBR textures


Aspect RatioExact (W×H)Exact PixelsRounded (W×H, ÷64)Rounded Pixels
1:11448 × 14482,096,7041408 × 14081,982,464
3:21773 × 11822,095,6861728 × 11521,990,656
4:31672 × 12542,096,6881664 × 12162,023,424
16:91936 × 10892,108,3041920 × 10882,088,960
21:92212 × 9482,096,9762176 × 9602,088,960
1:11024 × 10241,048,5761024 × 10241,048,576
3:21254 × 8361,048,3441216 × 8321,011,712
4:31182 × 8871,048,4341152 × 8961,032,192
16:91365 × 7681,048,3201344 × 7681,032,192
21:91564 × 6701,047,8801536 × 640983,040
1:1323 × 323104,329320 × 320102,400
3:2397 × 264104,808384 × 25698,304
4:3374 × 280104,720448 × 320143,360
16:9432 × 243104,976448 × 256114,688
21:9495 × 212104,940576 × 256147,456

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/bytedance/seedream-v4/edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "2048*2048",
    "enable_sync_mode": false,
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagesarrayYes[]-The images to edit. A maximum of 10 reference images can be uploaded.
sizestringNo2048*20481024 ~ 4096 per dimensionThe size of the generated media, supporting up to 4K resolution for images. If you need to match the size of an existing image, you must explicitly specify the dimensions, as automatic resizing to match the image is not supported.
enable_sync_modebooleanNofalse-If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.