GET

/v1/schemas/fal/image/fal-ai/pulid

Accept:

kind inputactivity imagehash d7ce909d…extracted Oct 9, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `37efd6dac175d1739333bc1e1258d5ef9dd9e471045817443b06db31c9b2b156` { "fetchedAt": 1791522002, "extractorVersion": "1", "verifiedAt": null }

Request body

12 properties · 2 required · 2 $defs

property	type	description	constraints
reference_images*	ReferenceFace[]	List of reference faces, ideally 4 images.
prompt*	string	Prompt to generate the face from
guidance_scale	number	Guidance scale	1 ≤ n ≤ 1.5 · default: 1.2
id_scale	number	ID scale	0 < n ≤ 5 · default: 0.8
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
seed	integer	Random seed for reproducibility	nullable
image_size	ImageSize \| enum	Size of the generated image	default: {"height":1024,"width":768}
id_mix	boolean	if you want to mix two ID image, please turn this on, otherwise, turn this off	default: false
num_images	integer	Number of images to generate	1 ≤ n ≤ 8 · default: 1
negative_prompt	string	Negative prompt to generate the face from	default: "flaws in the eyes, flaws in the…
mode	enum	Mode of generation	fidelity \| extreme style · default: "fidelity"
num_inference_steps	integer	Number of steps to take	1 ≤ n ≤ 12 · default: 4

Types

2 $defs

ImageSizeobject

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

ReferenceFaceobject

image_url*

string

URL of the reference face image

Validate a payload

before you spend tokens

shell

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