GET
/v1/schemas/fal/image/fal-ai/fooocus/inpaint
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace8d337aa4aad4d9d59424c1dcc4396ae284546d197daab0d6d0578f58a10fe2d0{
"fetchedAt": 1794373202,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
32 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| inpaint_image_url* | string | The image to use as a reference for inpainting. | |
| 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 |
| mask_image_url | string | The image to use as a mask for the generated image. | nullable |
| performance | enum | You can choose Speed or Quality | Speed | Quality | Extreme Speed | Lightning · default: "Extreme Speed" |
| inpaint_additional_prompt | string | Describe what you want to inpaint. | default: "" |
| 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 | ||
| 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: "" |
| inpaint_strength | number | Same as the denoising strength in A1111 inpaint. Only used in inpaint, not used in outpaint. (Outpaint always use 1.0) | 0 < n ≤ 1 · default: 1 |
| image_prompt_1 | ImagePrompt | ||
| output_format | enum | The format of the generated image. | png | jpeg | webp · default: "jpeg" |
| mixing_image_prompt_and_inpaint | boolean | Mixing Image Prompt and Inpaint | default: false |
| inpaint_disable_initial_latent | boolean | If set to true, the initial preprocessing will be disabled. | default: false |
| 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 |
| override_inpaint_options | boolean | If set to true, the advanced inpaint options ('inpaint_disable_initial_latent', 'inpaint_engine', 'inpaint_strength', 'inpaint_respective_field', 'inpaint_erode_or_dilate') will be overridden. Otherwise, the default values will be used. | default: false |
| 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" |
| inpaint_respective_field | number | The area to inpaint. Value 0 is same as "Only Masked" in A1111. Value 1 is same as "Whole Image" in A1111. Only used in inpaint, not used in outpaint. (Outpaint always use 1.0) | 0 ≤ n ≤ 1 · default: 0.618 |
| enable_safety_checker | boolean | If set to false, the safety checker will be disabled. | default: true |
| inpaint_mode | enum | The mode to use for inpainting. | Inpaint or Outpaint (default) | Improve Detail (face, hand, eye… | Modify Content (add objects, ch… · default: "Inpaint or Outpaint (default)" |
| 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" |
| inpaint_engine | enum | Version of Fooocus inpaint model | None | v1 | v2.5 | v2.6 · default: "v2.6" |
| outpaint_selections | enum[] | The directions to outpaint. | default: [] |
| invert_mask | boolean | If set to true, the mask will be inverted. | default: false |
| 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",… |
| inpaint_erode_or_dilate | number | Positive value will make white area in the mask larger, negative value will make white area smaller. (default is 0, always process before any mask invert) | -64 ≤ n ≤ 64 · default: 0 |
| 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… |
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/inpaint","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}