GET

/v1/schemas/fal/image/fal-ai/playground-v25/inpainting

kind inputactivity imagehash 1a37d433…extracted Oct 27, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
222f1dfa791c282ad95b073943d918b3b94245e3c0553d3961372ca6e64c4911
{
  "fetchedAt": 1793077201,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

16 properties · 3 required · 2 $defs
propertytypedescriptionconstraints
image_url*stringThe URL of the image to use as a starting point for the generation.
mask_url*stringThe URL of the mask to use for inpainting.
prompt*stringThe prompt to use for generating the image. Be as descriptive as possible for best results.
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 8 · default: 1
guidance_scalenumberThe 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
formatenumThe format of the generated image.jpeg | png · default: "jpeg"
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 65 · default: 25
request_idstringAn id bound to a request, can be used with response to identify the request itself.default: ""
seedinteger The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. nullable
negative_promptstringThe 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: ""
image_sizeImageSize | enumThe size of the generated image.default: "square_hd"
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled.default: true
strengthnumberdetermines how much the generated image resembles the initial image0.01 ≤ n ≤ 1 · default: 0.95
embeddingsEmbedding[]The list of embeddings to use.default: []
safety_checker_versionenumThe 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_promptbooleanIf set to true, the prompt will be expanded with additional prompts.default: false

Types

2 $defs

Embeddingobject

tokensstring[] 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*stringURL or the path to the embedding weights.

ImageSizeobject

heightintegerThe height of the generated image.0 < n ≤ 14142 · default: 512
widthintegerThe width of the generated image.0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/playground-v25/inpainting","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}