GET

/v1/schemas/fal/image/fal-ai%2Ffast-fooocus-sdxl%2Fimage-to-image

kind inputactivity imagehash c71afab7extracted Jul 6, 2026version currentsource upstream spec ↗

Request body

18 properties · 2 required · 2 $defs
propertytypedescriptionconstraints
image_url*stringThe URL of the image to use as a starting point for the generation.
prompt*stringThe prompt to use for generating the image. Be as descriptive as possible for best results.
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 8 · default: 1
formatenumThe format of the generated image.jpeg | png · default: "jpeg"
preserve_aspect_ratiobooleanIf set to true, the aspect ratio of the generated image will be preserved even if the image size is too large. However, if the image is not a multiple of 32 in width or height, it will be resized to the nearest multiple of 32. By default, this snapping to the …default: false
strengthnumberdetermines how much the generated image resembles the initial image0.05 ≤ n ≤ 1 · default: 0.95
negative_promptstringThe negative prompt to use.Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).default: ""
enable_refinerbooleanIf set to true, a smaller model will try to refine the output after it was processed.default: true
image_sizeImageSize | enumThe size of the generated image. Leave it none to automatically infer from the prompt image.nullable · default: null
expand_promptbooleanIf set to true, the prompt will be expanded with additional prompts.default: true
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled.default: true
crop_outputbooleanIf set to true, the output cropped to the proper aspect ratio after generating.default: false
seedinteger The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. nullable
embeddingsEmbedding[]The list of embeddings to use.default: []
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 24 · default: 8
request_idstringAn id bound to a request, can be used with response to identify the request itself.default: ""
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: 2
safety_checker_versionenumThe version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model.v1 | v2 · default: "v1"

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/fast-fooocus-sdxl/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}