GET
/v1/schemas/fal/image/fal-ai/fast-sdxl-controlnet-canny
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traced152ac4f8052d48d0f44eb8dec305db9c8e74ff3cca32fa10f9e35c89a64b5fb{
"fetchedAt": 1793077201,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
17 properties · 2 required · 3 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to use for generating the image. Be as descriptive as possible for best results. | |
| control_image_url* | string | The URL of the control image. | |
| negative_prompt | string | The 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: "" |
| format | enum | The format of the generated image. | jpeg | png · default: "jpeg" |
| controlnet_conditioning_scale | number | The scale of the controlnet conditioning. | 0 ≤ n ≤ 1 · default: 0.5 |
| request_id | string | An id bound to a request, can be used with response to identify the request itself. | default: "" |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 8 · default: 1 |
| seed | integer | The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. | nullable |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. | default: true |
| num_inference_steps | integer | The number of inference steps to perform. | 1 ≤ n ≤ 70 · default: 35 |
| safety_checker_version | enum | The version of the safety checker to use. v1 is the default CompVis safety checker. v2 uses a custom ViT model. | v1 | v2 · default: "v1" |
| expand_prompt | boolean | If set to true, the prompt will be expanded with additional prompts. | default: false |
| image_size | ImageSize | enum | The size of the generated image. Leave it none to automatically infer from the control image. | nullable · default: null |
| embeddings | Embedding[] | The list of embeddings to use. | default: [] |
| guidance_scale | number | The 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 |
| 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 |
| loras | LoraWeight[] | The list of LoRA weights to use. | default: [] |
Types
3 $defsEmbeddingobject
| tokens | string[] | The list of tokens to use for the embedding. When omitted, tokens are generated as <s0>, <s1>, ... to match the number of vectors in the embedding file. | nullable |
| path* | string | URL or the path to the embedding weights. |
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 |
LoraWeightobject
| scale | number | The scale of the LoRA weight. This is used to scale the LoRA weight before merging it with the base model. | 0 ≤ n ≤ 1 · default: 1 |
| force | boolean | If set to true, the embedding will be forced to be used. | default: false |
| path* | string | URL or path to a LoRA safetensors file. Or HF model name that resolves to safetensors weights. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/fast-sdxl-controlnet-canny","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}