GET
/v1/schemas/fal/image/fal-ai/fooocus/image-prompt
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace747d26ac70d802664084f2aa568f7d09293378036256b8d7a2470167aa43fea5{
"fetchedAt": 1794373202,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
28 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| image_prompt_1* | ImagePrompt | ||
| 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 |
| 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" |
| mixing_image_prompt_and_vary_upscale | boolean | Mixing Image Prompt and Vary/Upscale | default: false |
| inpaint_additional_prompt | string | Describe what you want to inpaint. | default: "" |
| 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)" |
| uov_image_url | string | The image to upscale or vary. | nullable |
| 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_image_url | string | The image to use as a reference for inpainting. | nullable |
| 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 | ||
| outpaint_selections | enum[] | The directions to outpaint. | default: [] |
| 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: "Disabled" |
| 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 |
| 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 |
| 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… |
| 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 |
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/image-prompt","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}