GET

/v1/schemas/fal/image/bytedance/seedream/v5.5/layerize?kind=output

Accept:

kind outputactivity imagehash 9b0c99d2…extracted Nov 13, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `c667519ef1d71db004503bafcbb1b510a671b321e610abc9a9a1f50b66fa3550` { "fetchedAt": 1794546001, "extractorVersion": "2", "verifiedAt": null }

Response body

2 properties · 2 required · 7 $defs

property	type	description	constraints
layers*	SeedDream55Layer[]	The base image followed by up to 99 separated layers, ordered by increasing z_index.
images*	Image[]	The same images as `layers`, in the same order, flattened for gallery rendering.

Types

7 $defs

Imageobject

Represents an image file.

file_size	integer	The size of the file in bytes.	nullable
width	integer	The width of the image in pixels.	nullable
file_name	string	The name of the file. It will be auto-generated if not provided.	nullable
height	integer	The height of the image in pixels.	nullable
content_type	string	The mime type of the file.	nullable
url*	string	The URL where the file can be downloaded from.

SeedDream50ProLayerBoundingBoxobject

absolute*	integer[]	Layer bounds as [left, top, right, bottom] pixel coordinates in the output base image coordinate system.	items ≥ 4 · items ≤ 4
normalized*	integer[]	Layer bounds as [left, top, right, bottom] coordinates normalized to the integer range [0, 1000].	items ≥ 4 · items ≤ 4

SeedDream55Layerobject

text_recognition	SeedDream55TextRecognition	Rich-text OCR result. Present only for formatted text layers when `enable_text_recognition` is set.	nullable
name	string	Model-generated label for the layer. Omitted for the base image.	nullable
z_index*	integer	Stacking order from bottom to top. The base image always has z_index 0.	0 ≤ n ≤ 99
bounding_box	SeedDream50ProLayerBoundingBox	The layer's position in the base image coordinate system. Omitted for the base image.	nullable
image*	Image	The generated base image or separated layer.
description	string	Detailed model-generated description of the layer. Omitted for the base image.	nullable

SeedDream55TextLineobject

bounding_box*	SeedDream50ProLayerBoundingBox	The line's position in the base image coordinate system.
runs*	SeedDream55TextRun[]	Styled fragments in order.

SeedDream55TextRecognitionobject

lines*	SeedDream55TextLine[]	Text lines in order.
text*	string	Full text of the layer, lines separated by `\n`.

SeedDream55TextRunobject

style*	SeedDream55TextStyle	Approximate visual style.
text*	string	Text fragment that shares one style.

SeedDream55TextStyleobject

bold	boolean	Whether the text is bold.	default: false
foreground_color	string	Text color as uppercase `#RRGGBB`.	nullable
similar_font_family	string	Closest matching font, or `unknown` when it cannot be recognized.	default: "unknown"
shadow	boolean	Whether the text has a drop shadow or glow.	default: false
underline	boolean	Whether the text is underlined.	default: false
translucent	boolean	Whether the text strokes are translucent.	default: false
italic	boolean	Whether the text is italic.	default: false
strikethrough	boolean	Whether the text has a strikethrough.	default: false

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"bytedance/seedream/v5.5/layerize","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}