GET

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

Accept:

kind inputactivity imagehash cc1927d1…extracted Oct 29, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `6eba71b61dba5bb11bc1bc6e4cc20e14317bd0d4b86d87eeb2c31b4c635aa9b2` { "fetchedAt": 1793250001, "extractorVersion": "1", "verifiedAt": null }

Request body

14 properties · 1 required · 4 $defs

property	type	description	constraints
prompt*	string
image_urls	string[]	A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format	nullable
seed	integer	Seed for the random number generator	nullable
color_palette	ColorPalette	A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members)	nullable
negative_prompt	string	Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.	default: ""
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
style_codes	string[]	A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style	nullable
num_images	integer	Number of images to generate.	1 ≤ n ≤ 8 · default: 1
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
image_size	ImageSize \| enum	The resolution of the generated image	nullable · default: "square_hd"
rendering_speed	enum	The rendering speed to use.	TURBO \| BALANCED \| QUALITY · default: "BALANCED"
style	enum	The style type to generate with. Cannot be used with style_codes.	AUTO \| GENERAL \| REALISTIC \| DESIGN · nullable
style_preset	enum	Style preset for generation. The chosen style preset will guide the generation.	80S_ILLUSTRATION \| 90S_NOSTALGIA \| ABSTRACT_ORGANIC \| ANALOG_NOSTALGIA \| ART_BRUT \| ART_DECO · +56 more · nullable
enable_prompt_expansion	boolean	Determine if MagicPrompt should be used in generating the request or not.	default: true

Types

4 $defs

ColorPaletteobject

members	ColorPaletteMember[]	A list of color palette members that define the color palette	nullable
name	enum	A color palette preset value	EMBER \| FRESH \| JUNGLE \| MAGIC \| MELON \| MOSAIC · +2 more · nullable

ColorPaletteMemberobject

color_weight	number	The weight of the color in the color palette	0.05 ≤ n ≤ 1 · nullable
rgb*	RGBColor	RGB color value for the palette member

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

RGBColorobject

b	integer	Blue color value	0 ≤ n ≤ 255 · default: 0
g	integer	Green color value	0 ≤ n ≤ 255 · default: 0
r	integer	Red color value	0 ≤ n ≤ 255 · default: 0

Validate a payload

before you spend tokens

shell

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