GET
/v1/schemas/fal/image/fal-ai/fooocus/upscale-or-vary
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceeab242e532671ad8515cb6a19b63c01bffaf7fb55a3afdc16f472334d2cedc76{
"fetchedAt": 1794373202,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
22 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| uov_image_url* | string | The image to upscale or vary. | |
| 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 |
| 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. | 1 ≤ n ≤ 30 · default: 4 |
| aspect_ratio | string | The size of the generated image. You can choose between some presets or custom height and width that **must be multiples of 8**. | default: "1024x1024" |
| performance | enum | You can choose Speed or Quality | Speed | Quality | Extreme Speed | Lightning · default: "Extreme Speed" |
| enable_safety_checker | boolean | If set to false, the safety checker will be disabled. | default: true |
| num_images | integer | Number of images to generate in one request | 1 ≤ n ≤ 4 · default: 1 |
| image_prompt_4 | ImagePrompt | ||
| image_prompt_2 | ImagePrompt | ||
| refiner_model | enum | Refiner (SDXL or SD 1.5) | None | realisticVisionV60B1_v51VAE.saf… · default: "None" |
| refiner_switch | number | Use 0.4 for SD1.5 realistic models; 0.667 for SD1.5 anime models 0.8 for XL-refiners; or any value for switching two SDXL models. | 0 ≤ n ≤ 1 · default: 0.8 |
| 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 |
| image_prompt_3 | ImagePrompt | ||
| prompt | string | The prompt to use for generating the image. Be as descriptive as possible for best results. | default: "" |
| styles | enum[] | The style to use. | default: ["Fooocus V2","Fooocus Enhance",… |
| uov_method | enum | The method to use for upscaling or varying. | Disabled | Vary (Subtle) | Vary (Strong) | Upscale (1.5x) | Upscale (2x) | Upscale (Fast 2x) · default: "Vary (Strong)" |
| output_format | enum | The format of the generated image. | png | jpeg | webp · default: "jpeg" |
| image_prompt_1 | ImagePrompt | ||
| loras | LoraWeight[] | The LoRAs to use for the image generation. You can use up to 5 LoRAs and they will be merged together to generate the final image. | default: [{"path":"https://huggingface.co… |
| 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: "" |
| sharpness | number | The sharpness of the generated image. Use it to control how sharp the generated image should be. Higher value means image and texture are sharper. | 0 ≤ n ≤ 30 · default: 2 |
| mixing_image_prompt_and_vary_upscale | boolean | Mixing Image Prompt and Vary/Upscale | default: false |
Types
2 $defsImagePromptobject
| type | enum | ImagePrompt | PyraCanny | CPDS | FaceSwap · default: "ImagePrompt" | |
| image_url | string | nullable | |
| weight | number | 0 ≤ n ≤ 2 · default: 1 | |
| stop_at | number | 0 ≤ n ≤ 1 · default: 0.5 |
LoraWeightobject
| path* | string | URL or the path to the LoRA weights. | |
| 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: 0.1 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/fooocus/upscale-or-vary","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}