Providers and ModelsByteDance

Seedream 4.0

Seedream 4.0
ByteDance · Image Generation
POST /v1/images/generations

Unified image generation and editing with up to 14 reference images, batch sets of up to 15, and 1K to 4K output at one flat per-image price.

At a glance

FieldValue
Model idseedream-4-0
Model release date2025-09-09
Input modalitiesText, Image
Output modalitiesImage
Context window-
Weight precision-
RegionMalaysia
Featuresediting, batch_generation
Native inferenceNo
NewNo
Supported endpointsPOST /v1/images/generations
Alternate model idsbytedance/seedream-4.0, seedream-4.0, seedream-4, seedream-4-0-250828

Pricing

ChargeSpecRate
Standardper image$0.060

Example request

$curl https://api.empiriolabs.ai/v1/images/generations \
>  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
>  -H 'Content-Type: application/json' \
>  -d '{"model": "seedream-4-0", "prompt": "a misty forest at dawn", "size": "1024x1024"}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringyes-Text prompt. With image attached, becomes an editing instruction. For batch mode, describe each image sequentially.
aspect_ratioenumno"auto"Auto lets the model choose dimensions within the selected resolution tier. Explicit ratios use the preset size for that tier. · Allowed: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9
qualityenumno"2K"Output resolution tier. Every tier bills at the same flat per-image rate. · Allowed: 1K, 2K, 4K
prompt_optimization_modeenumno"standard"Standard prioritizes prompt adherence and image quality. Fast reduces generation latency with slightly lower image quality. · Allowed: standard, fast
use_custom_sizebooleannofalseUse custom_width and custom_height instead of preset aspect_ratio and quality.
custom_widthnumberno-Pixels. Total area must be in [0.92MP, 16.78MP]; aspect must be in [1:16, 16:1]. Only when use_custom_size=true. · Range: 720 – 6240
custom_heightnumberno-Pixels. Total area must be in [0.92MP, 16.78MP]; aspect must be in [1:16, 16:1]. Only when use_custom_size=true. · Range: 720 – 6240
imagearrayno-Up to 14 reference image URLs for editing. Triggers image-edit mode.
imagesarrayno-Alias for image. Use this for multiple uploaded image references.
batch_enabledbooleannofalseGenerate a cohesive set of related images from a single prompt.
max_imagesnumberno4Batch mode only. Maximum images in the set; the model decides actual count. You are billed only for images returned. · Range: 1 – 15
watermarkbooleannofalseWhen enabled, the generated image includes an AI-generated provenance watermark. EmpirioLabs does not add a separate watermark.
response_formatenumno"url"Return signed image URLs by default, or include base64 image data when b64_json is requested. · Allowed: url, b64_json

Notes

Text-to-image, single-reference editing, and multi-reference generation from up to 14 input images, plus batch sets of up to 15 related images. Every size bills at the same flat per-image rate, and input reference images are free.

Output

  • 1K, 2K, or 4K tiers, or an explicit size between 0.92MP and 16.78MP total pixels. JPEG output.
  • A fast prompt-optimization mode trades a little quality for lower latency.

Batch mode

  • sequential_image_generation auto generates a cohesive set; you are billed only for images actually returned.

Content safety

  • Generated images pass an automated content-safety check. An image flagged as explicit is not returned. Because the image is generated before the check runs, a flagged generation is still billed.

Machine-readable schema: GET https://api.empiriolabs.ai/v1/models/seedream-4-0.