default-group token, so most integrations switch by changing model and removing two unsupported fields.
- Published: September 25, 2026
- Last verified: September 25, 2026
- Status: Active. Both models are available in the
defaulttoken group.
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 can split an existing image into a background and separate transparent layers.
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
5.0 Flash can decompose one reference image into layers. Setlayer_decomposition to true and send exactly one image:
data[]:
layer-1.pngis the background, with the areas behind removed elements filled in by the model.- Each remaining file is one element as a transparent RGBA PNG.
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, at $0.018 each. The model decides how many layers to return, and you can’t set the count in advance, so a request that returns 16 images costs $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 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