default-group token, so most integrations switch by changing model and removing two unsupported fields.
- Published: September 25, 2026
- Last verified: September 26, 2026
- Status: Active. Both models are available in the
defaulttoken group. - Correction, September 26: 5.0 Pro also supports layer decomposition, at $0.12 per returned image. This page first listed it as a 5.0 Flash feature only.
Key facts
Who should care
- High-volume image work: ad creatives, e-commerce product images, posters, and marketing graphics with text. BytePlus positions 5.0 Flash for faster output, stronger layout and typography, and lower cost at scale.
- Top-quality images: realistic portraits, fine material detail, professional scenes, and complex instructions. 5.0 Pro has the best image quality and instruction following of the Seedream models, and supports interactive edits, where you describe changes by position in the image.
- Transparent assets: 5.0 Flash and 5.0 Pro can split an existing image into a background and separate transparent layers. Flash is the economical choice.
What to do
1
Check your token
Use an API key in the
default group with the billing mode set to Usage first or Per-call. Confirm that both models appear on the console pricing page.2
Change the model and remove unsupported fields
Set
model to the 5.0 Flash or 5.0 Pro model ID. Delete sequential_image_generation, even when it’s "disabled", and stream from the request.3
Set the size and client timeout
Pick a
size the model accepts. Set the client timeout to at least 60 seconds for 5.0 Flash and at least 240 seconds for 5.0 Pro.4
Compare before you switch batch jobs
Run a few of your own prompts on the new model and on your current one, then compare quality, time, and cost in call logs.
Generate an image with 5.0 Flash
This request creates one 2K image without a watermark, then downloads it. Replace the placeholder with your LaoZhang API key; the download step usesjq:
data[0].url and stays valid for about 24 hours, so download it promptly. Without "watermark": false, the image gets an “AI generated” label.
To use 5.0 Pro, change model to seedream-5-0-pro-260628 and raise --max-time to at least 240. For edits, Python, and the full parameter list, see the Seedream API guide.
Split an image into transparent layers
Both 5.0 Flash and 5.0 Pro can decompose one reference image into a filled-in background and separate transparent layers. Both charge for every returned image, and Pro costs about 6.7 times as much per image, so use Flash unless you have a reason not to. Setlayer_decomposition to true and send exactly one image:
image URL with a publicly downloadable image of your own. For 5.0 Pro, change only model. A few request rules differ from normal edits:
promptis optional. Without one, the model detects the main elements itself.- Set
sizeto1K. Exact pixels aren’t accepted. - Layer requests accept only the levels
1K,1.5K,2K, andauto. - Only 5.0 Flash and 5.0 Pro accept
layer_decomposition. Seedream 5.0 and 4.5 reject it with HTTP 400 (InvalidParameter).
data[]:
layer-0.jpegis the background, with the areas behind removed elements filled in by the model. Its format followsoutput_format, which defaults tojpeg.- Each remaining file is one element as a transparent RGBA PNG, named by its stacking order (
z_index).
Migration notes
When you move a Seedream 5.0 or 4.x request to 5.0 Flash or 5.0 Pro, check these fields:sequential_image_generationandstream: remove both. Any value, including"disabled", returns HTTP 400.n: ignored. Each request returns one image, except for layer decomposition, so send separate requests when you need several.sizelevels: 5.0 Flash accepts 1K, 1.5K, and 2K, and uses 2K whensizeis omitted. 3K and 4K return HTTP 400. 5.0 Pro accepts 1K and 2K.- Aspect ratio: with a
sizelevel, 5.0 Flash chooses the aspect ratio from the content. For a fixed ratio, pass exact pixels such as2560x1440. - Exact pixels on 5.0 Flash: 921,600 to 4,624,220 pixels in total, with the long side no more than 16 times the short side.
- Exact pixels on 5.0 Pro: up to about 4.19 million pixels, for example
2048x2048, or2720x1530for 16:9. - Reference images: up to 10. An eleventh returns HTTP 400.
- Output format:
output_formatacceptspngorjpeg. - Response format:
response_formatacceptsurl(valid for about 24 hours) orb64_json.
Compare Seedream versions
5.0 Pro costs about 3.4 times as much as 5.0 and is slower, so use 5.0 or 5.0 Flash for routine work. Prices are LaoZhang API public pricing as of September 25, 2026.
Frequently asked questions
How is layer decomposition billed?
Per returned image: $0.018 each on 5.0 Flash and $0.12 each on 5.0 Pro. The model decides how many layers to return, and you can’t set the count in advance. A 6-image result costs $0.108 on Flash and $0.72 on Pro, and 16 images on Flash cost $0.288. A request that fails with HTTP 400 because the image can’t be decomposed isn’t charged.Why does my request return HTTP 400 after switching from Seedream 5.0?
Check these causes, most common first:- The request still includes
sequential_image_generationorstream. Remove both. sizeis a level the model doesn’t accept, such as3Kor4K.- The request sends more than 10 reference images.
Does 5.0 Pro cost more at 2K or with reference images?
No. LaoZhang API charges a flat $0.12 for each output image at any size. The first reference image is free, and each additional one costs $0.003, so ten references add at most $0.027. BytePlus’s own pricing for 5.0 Pro depends on output resolution and also charges for input reference images.Can I get a transparent background by asking for one in the prompt?
No. The output has no alpha channel. Use layer decomposition with 5.0 Flash or 5.0 Pro to get transparent PNG layers.Do I need to migrate from Seedream 5.0?
No.seedream-5-0-260128 stays available and remains the model for 3K output, sequential generation, and streaming. For 4K, keep using 4.5 or 4.0.
Am I charged if my client times out?
A client timeout isn’t the same as a failure, because the server may still finish the image and charge for it. Check call logs before you resend. Requests that return an error without an image, such as a parameter error, aren’t charged.Sources and related links
BytePlus
- BytePlus ModelArk image generation API: request parameters,
sizeranges, and URL lifetime - BytePlus image generation tutorial: model positioning, speed, and input image limits
LaoZhang API
Model IDs, prices, groups, and billing types come from LaoZhang API’s public pricing configuration as of September 25, 2026:- Model and pricing catalog: current prices for every Seedream version
- Console pricing page: the prices that apply to your account
- Token management: create an API key and set its group and billing mode
- Call logs: check the model and charge for each request