GET

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

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

upstream-spec

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

Request body

13 properties · 1 required · 2 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to use for generating the image. Be as descriptive as possible for best results.
seedinteger The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. nullable
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 8 · default: 1
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: ""
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
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
formatenumThe format of the generated image.jpeg | png · default: "jpeg"
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"
embeddingsEmbedding[]The list of embeddings to use.default: []
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 50 · default: 25
request_idstringAn id bound to a request, can be used with response to identify the request itself.default: ""
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","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}