GET

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

kind inputactivity imagehash c4f9b239…extracted Aug 10, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
bd26872073e17bfe742a978a7578534316c708904c7ece9c5eb982e8d46d2cc8
{
  "fetchedAt": 1786338105,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

13 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to generate an image from.
reference_image_url*stringURL of image to use for inpainting.
guidance_scalenumberThe CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.0 ≤ n ≤ 20 · default: 4
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 50 · default: 20
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images.default: true
seedinteger The same seed and the same prompt given to the same version of the model will output the same image every time. nullable
id_weightnumberThe weight of the ID loss.0 ≤ n ≤ 1 · default: 1
max_sequence_lengthenumThe maximum sequence length for the model.128 | 256 | 512 · default: "128"
image_sizeImageSize | enumThe size of the generated image.default: "landscape_4_3"
true_cfgnumberThe weight of the CFG loss.1 ≤ n ≤ 10 · default: 1
negative_promptstringThe prompt to generate an image from.default: ""
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
start_stepintegerThe number of steps to start the CFG from.0 ≤ n ≤ 50 · default: 0

Types

1 $defs

ImageSizeobject

widthintegerThe width of the generated image.0 < n ≤ 14142 · default: 512
heightintegerThe 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":"fal-ai/flux-pulid","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}