byteplus/seededit-3-0-i2i-250628 with the Comfy Router API. BytePlus provides the model; Router gives it the shared authentication and request route below.
Quick start
Create a key at platform.comfy.org/profile/api-keys and export it asCOMFY_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/seededit-3-0-i2i-250628
Endpoint: POST https://api.comfy.org/v2/models/byteplus/seededit-3-0-i2i-250628
Schema
Input
Router has not published an authored input schema for this model yet:
GET /v2/models/byteplus/seededit-3-0-i2i-250628/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:
uriinteger
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
Before you ship
Save oneIdempotency-Key for each call and reuse it for retries. Router can hold the connection for up to 10 minutes. The SDKs handle authentication; raw HTTP clients send the headers themselves.
Use X-Comfy-Error-Type to classify a failure. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.
Headers
Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.
Using the Router API
Find models, inspect schemas, and retry safely.
Limitations
What Router does not do today, and what to use instead.