GET
/v1/schemas/fal/image/fal-ai/stable-diffusion-v35-large
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace16a240818798149f15e21d32a82b88acd71400a4c00313d38ddc3b6c932cbc9a{
"fetchedAt": 1794459602,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
13 properties · 1 required · 4 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to generate an image from. | |
| 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: 3.5 |
| output_format | enum | The format of the generated image. | jpeg | png · default: "jpeg" |
| controlnet | ControlNet | ControlNet for inference. | |
| 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 |
| num_inference_steps | integer | The number of inference steps to perform. | 1 ≤ n ≤ 50 · default: 28 |
| loras | LoraWeight[] | The LoRAs to use for the image generation. You can use any number of LoRAs and they will be merged together to generate the final image. | default: [] |
| image_size | ImageSize | enum | The size of the generated image. Defaults to landscape_4_3 if no controlnet has been passed, otherwise defaults to the size of the controlnet conditioning image. | nullable |
| ip_adapter | IPAdapter | IP-Adapter to use during inference. | nullable |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| seed | integer | The same seed and the same prompt given to the same version of the model will output the same image every time. | nullable |
| 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: "" |
| enable_safety_checker | boolean | If 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 |
Types
4 $defsControlNetobject
| conditioning_scale | number | The scale of the control net weight. This is used to scale the control net weight before merging it with the base model. | 0 ≤ n ≤ 2 · default: 1 |
| start_percentage | number | The percentage of the image to start applying the controlnet in terms of the total timesteps. | 0 ≤ n ≤ 1 · default: 0 |
| end_percentage | number | The percentage of the image to end applying the controlnet in terms of the total timesteps. | 0 ≤ n ≤ 1 · default: 1 |
| path* | string | URL or the path to the control net weights. | |
| control_image_url* | string | URL of the image to be used as the control image. |
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 |
IPAdapterobject
| weight_name | string | Exact file containing content-valid safetensors IP-Adapter weights. Pickle .bin adapters require safe offline conversion to safetensors. | nullable |
| scale* | number | Scale for ip adapter. | |
| mask_threshold | number | Threshold for mask. | 0.01 ≤ n ≤ 0.99 · default: 0.5 |
| subfolder | string | Subfolder in which the ip_adapter weights exist | nullable |
| path* | string | HTTPS URL or Hugging Face repository for content-valid safetensors IP-Adapter weights. Convert .bin adapters to safetensors offline before uploading. | |
| image_url* | string | URL of Image for IP-Adapter conditioning. | |
| image_encoder_weight_name | string | Deprecated: custom image encoder files are not supported. | nullable |
| image_encoder_subfolder | string | Deprecated: custom image encoder files are not supported. | nullable |
| image_encoder_path* | string | Hugging Face repository of the IP-Adapter image encoder. Only 'google/siglip-so400m-patch14-384' is supported. | |
| mask_image_url | string | URL of the mask for the control image. | nullable |
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 ≤ 4 · default: 1 |
| path* | string | URL or the path to the LoRA weights. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/stable-diffusion-v35-large","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}