Use Seedream 4.5 251128 with Comfy Router

API Reference for byteplus/seedream-4-5-251128, served by Comfy Router from BytePlus.

Quick start

Create a key at platform.comfy.org/profile/api-keys and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP. Model ID: byteplus/seedream-4-5-251128 Endpoint: POST https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128

from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment. Each call sends a fresh
# Idempotency-Key and waits up to 10 minutes for the finished result.
with Comfy() as client:
    result = client.models.run(
        "byteplus/seedream-4-5-251128",
        {
            # Request fields are the provider's own — see Input below.
        },
    )

print(result)

import { comfy } from "@comfyorg/sdk";

// Reads COMFY_API_KEY from the environment. Each call sends a fresh
// Idempotency-Key and waits up to 10 minutes for the finished result.
const { data } = await comfy.models.run("byteplus/seedream-4-5-251128", {
  // Request fields are the provider's own — see Input below.
});

console.log(data);

# Request fields are the provider's own — see Input below.
curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128 \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'

Schema

Input

Router has not published an authored input schema for this model yet: GET /v2/models/byteplus/seedream-4-5-251128/openapi.json returns an open object with x-comfy-input-schema-authored: false. Router forwards the body to BytePlus unchanged, so BytePlus’s own API reference is authoritative for the request fields, and nothing is validated server side.

Output

integer

Unix timestamp (in seconds) indicating the time when the request was created

object[]

Contains information about the generated image(s). In the layer-separation scenario, the first element of the array is the base image (z_index=0), and the following elements are the layers, ordered by increasing z_index.

string

Base64-encoded image data (if response_format is “b64_json”)

object

The bounding-box information of the region that the current layer occupies within the base image. Only layers return this field; the base image covers the whole canvas and does not return bounding_box. Returned only when layer_decomposition is true.

integer[]

The absolute pixel coordinates of the layer’s bounding box, in the output base image’s coordinate system with the top-left corner at (0, 0). Coordinate format: [left, top, right, bottom].

integer[]

The per-mille quantized (normalized) coordinates of the layer’s bounding box, proportionally mapped to a discrete integer range of [0, 1000] based on the base image size, truncated at a maximum of 1000. Coordinate format: [left, top, right, bottom].

string

A detailed description of the current separated element, providing richer layer characteristics (such as color, state, material) than name. Only layers return this field; the base image does not. Returned only when layer_decomposition is true.

string

The name/label of the current separated element, automatically generated by the model from the characteristics of the separated subject. Only layers return this field; the base image does not. Returned only when layer_decomposition is true.

string

The file format of the output image. Only seedream-5.0-pro supports this field.

string

The width and height of the image in pixels, in the format <width>x<height>. Only seedream-5.0-pro, 5.0-lite, 4.5 and 4.0 support this parameter.

string (uri)

URL for image download (if response_format is “url”)Format: uri

integer

The stacking order of the layer, increasing from bottom to top: 0 is the bottom-most layer (the base image); larger values sit higher. Use it to recompose the layers into the complete image at the correct stacking order. Returned only when layer_decomposition is true.

object

Error information (if any)

string

Error code

string

Error message

string

The model ID used for the request

object

integer

Number of images generated by the model

integer

The number of images input to the model. Only seedream-5.0-pro supports this field.

integer

The number of tokens used for the picture generated by the model.

integer

The total number of tokens consumed by this request.

Examples

Output

{
  "created": 1767225600,
  "data": [
    {
      "size": "1024x1024",
      "url": "https://example.invalid/byteplus/seedream-3-0-t2i-250415/generated.png"
    }
  ],
  "model": "seedream-3-0-t2i-250415",
  "usage": {
    "generated_images": 1
  }
}

Before you ship

The snippets above are the shortest working call. Three things are the same for every model and are documented once on the Comfy Router headers page: send an Idempotency-Key on every paid call and reuse it when you retry, expect the connection to be held up to Router’s 10 minute deadline, and keep X-Comfy-Request-Id from every response. The SDKs do all three for you; the cURL tab does none of them. On failure, X-Comfy-Error-Type names the bucket, and a 422 means the body failed the model’s schema and was never billed.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Quick Start

Typed error handling in Python and TypeScript, reading the 422, walking the catalog.

Limitations

What Router does not do today, and what to use instead.

Develop with Comfy

Deploy ComfyUI

Run Workflows

Comfy Router

Comfy CLI

Specifications

Use Seedream 4.5 251128 with Comfy Router

Quick start

Schema

Input

Output

Examples

Output

Before you ship

Headers

Quick Start

Limitations

​Quick start

​Schema

​Input

​Output

​Examples

​Output

​Before you ship

Headers

Quick Start

Limitations

Quick start

Schema

Input

Output

Examples

Output

Before you ship