GET

/v1/schemas/fal/image/ideogram/v4.5

Accept:

kind inputactivity imagehash 1cbab192…extracted Nov 10, 2026version currentsource upstream spec ↗

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

Request body

8 properties · 1 required · 1 $defs

property	type	description	constraints
prompt*	string	The generation or editing prompt.	length ≥ 1 · length ≤ 10000
num_images	integer	Number of images to generate.	1 ≤ n ≤ 8 · default: 1
image_size	ImageSize \| enum	Output size. square is promoted to square_hd (1024x1024). 4:3 presets use 1152x864 or 864x1152; 16:9 presets use 1280x720 or 720x1280. Explicit dimensions must match a supported size: 1024x1024, 1024x3072, 1120x896, 1152x2944, 1152x864, 1248x3328, 1248x832, 12…	default: "square_hd"
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
seed	integer	Random seed. Omit to choose automatically.	nullable
quality	enum	Text-to-image quality.	low \| medium \| high · default: "medium"
sync_mode	boolean	Return image data directly in the response.	default: false
enable_prompt_expansion	boolean	Enable partner prompt expansion.	default: true

Types

1 $defs

ImageSizeobject

width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512
height	integer	The height of the generated image.	0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens

shell

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