GET

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

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

Request body

21 properties · 3 required · 3 $defs
propertytypedescriptionconstraints
control_image_url*stringThe URL of the control image.
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.
strengthnumberdetermines how much the generated image resembles the initial image0.05 ≤ n ≤ 1 · default: 0.95
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 70 · default: 35
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 8 · default: 1
seedinteger The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. nullable
lorasLoraWeight[]The list of LoRA weights to use.default: []
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
formatenumThe format of the generated image.jpeg | png · default: "jpeg"
controlnet_conditioning_scalenumberThe scale of the controlnet conditioning.0 ≤ n ≤ 1 · default: 0.5
embeddingsEmbedding[]The list of embeddings to use.default: []
image_sizeImageSize | enumThe size of the generated image. Leave it none to automatically infer from the control image.nullable · default: null
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
expand_promptbooleanIf set to true, the prompt will be expanded with additional prompts.default: false
request_idstringAn id bound to a request, can be used with response to identify the request itself.default: ""
crop_outputbooleanIf set to true, the output cropped to the proper aspect ratio after generating.default: false
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"
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled.default: true
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: ""
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: 7.5

Validate a payload

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