Skip to main content
ByteDanceMediumUltra

Seedream 5 Pro

ByteDance's flagship Seedream 5.0 Pro image generation model, with built-in reasoning, precise instruction following, and multi-reference support for up to 10 images. Offers 1K and 2K resolution output with higher fidelity than Seedream 5 Lite.

210 credits
per image, tiered by resolution
Built-in reasoning for precise instruction following
Multi-reference generation with up to 10 input images
1K and 2K resolution output
Aspect ratio auto-match to the input image
Higher fidelity than the Seedream 5 Lite sibling model
PNG or JPEG output format

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "bytedance/seedream-5-pro",
  "input": {
    "prompt": "Combine these three sneaker reference photos into a single studio product shot on a seamless white background, consistent lighting from the upper left, and a soft shadow beneath each shoe",
    "image_input": [
      "https://example.com/sneaker-1.jpg",
      "https://example.com/sneaker-2.jpg",
      "https://example.com/sneaker-3.jpg"
    ],
    "size": "2K",
    "aspect_ratio": "1:1"
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text prompt for image generation. Maximum 4000 characters. BytePlus recommends keeping prompts under 600 English words for best results.
image_inputarrayNo[]Input image(s) for image-to-image generation. List of 1-10 reference images for single or multi-reference generation.
sizestringNo2KImage resolution: 1K (~2 megapixels) or 2K (~4 megapixels).
1K2K
aspect_ratiostringNomatch_input_imageImage aspect ratio. Use 'match_input_image' to automatically match the input image's aspect ratio.
match_input_image1:14:33:416:99:163:22:321:9
output_formatstringNopngOutput image format.
pngjpeg

How to Provide File Input

There are 3 ways to provide files for the image_input parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=bytedance/seedream-5-pro" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_input=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "bytedance/seedream-5-pro",
  "input": {
    "prompt": "your prompt here",
    "image_input": ["https://example.com/image.jpg"]
  }
}
See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Multi-Reference Product Composite

Combine multiple product reference photos into a single cohesive studio shot

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "bytedance/seedream-5-pro",
  "input": {
    "prompt": "Combine these three sneaker reference photos into a single studio product shot on a seamless white background, consistent lighting from the upper left, and a soft shadow beneath each shoe",
    "image_input": [
      "https://example.com/sneaker-1.jpg",
      "https://example.com/sneaker-2.jpg",
      "https://example.com/sneaker-3.jpg"
    ],
    "size": "2K",
    "aspect_ratio": "1:1"
  }
}'

High-Resolution Marketing Banner

Text-only prompt generating a wide banner at 2K resolution

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "bytedance/seedream-5-pro",
  "input": {
    "prompt": "A minimalist tech product launch banner featuring sleek wireless earbuds floating above a reflective dark surface, dramatic rim lighting, deep navy background with a subtle gradient",
    "size": "2K",
    "aspect_ratio": "21:9",
    "output_format": "png"
  }
}'

Tips & Best Practices

1Set size to 1K when maximum resolution isn't required โ€” it's the lighter tier below 2K
2Provide up to 10 reference images in image_input for consistent multi-subject composites instead of relying on prompt text alone
3Use aspect_ratio: match_input_image when editing a reference photo to preserve its original framing
4Keep prompts under roughly 600 English words per BytePlus guidance โ€” longer prompts don't improve fidelity

Use Cases

Production-grade marketing visuals requiring precise instruction following
Multi-reference product photography combining up to 10 source images
High-resolution (2K) hero images for campaigns
Image-to-image editing guided by multiple reference photos
Batch content production that must preserve the input image's aspect ratio