GET

/v1/schemas/fal/image/fal-ai/ideogram/v3/layerize-text

Accept:

kind inputactivity imagehash 96848867…extracted Oct 28, 2026version currentsource upstream spec ↗

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

Request body

13 properties · 1 required · 0 $defs

property	type	description	constraints
image_url*	string	URL of the flat graphic image to layerize. Must be JPEG, PNG, or WebP (max 10MB).
font_file_h2_url	string	URL of the font file to use for h2 text. Cannot be used with font_name_h2.	nullable
font_name_small	string	Name of the font to use for small text. Cannot be used with font_file_small_url.	nullable
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	default: false
font_file_h1_url	string	URL of the font file to use for h1 text. Cannot be used with font_name_h1.	nullable
font_file_small_url	string	URL of the font file to use for small text. Cannot be used with font_name_small.	nullable
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
font_name_body	string	Name of the font to use for body text. Cannot be used with font_file_body_url.	nullable
prompt	string	Optional prompt to guide the layerization.	nullable
seed	integer	Seed for the random number generator.	nullable
font_file_body_url	string	URL of the font file to use for body text. Cannot be used with font_name_body.	nullable
font_name_h1	string	Name of the font to use for h1 text. Cannot be used with font_file_h1_url.	nullable
font_name_h2	string	Name of the font to use for h2 text. Cannot be used with font_file_h2_url.	nullable

Validate a payload

before you spend tokens

shell

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