GET

/v1/schemas/fal/image/fal-ai/phota

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

upstream-spec

Source trace
a7820b42566dc627d7f63671342ffb48d42c57e18f1dc59cfa947ac0eb6d0ed6
{
  "fetchedAt": 1791522002,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

8 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringText description of the desired image. In case you wish to use specific profiles, refer to them as [[profile_id_1]], [[profile_id_2]], etc.
num_imagesintegerNumber of images to generate.1 ≤ n ≤ 4 · default: 1
base_modelenumBase model used to render the image. Identity composes on top of whichever base model is selected, so trained profiles work with all of them. Only `nb2` supports `4K`.nb2 | qwen-image-2 | flux-2 | seedream-5-pro · default: "nb2"
aspect_ratioenumAspect ratio of the generated image.auto | 1:1 | 16:9 | 4:3 | 3:4 | 9:16 · default: "auto"
output_formatenumThe format of the generated image.jpeg | png · default: "jpeg"
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
resolutionenumResolution of the generated image.1K | 4K · default: "1K"
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true

Validate a payload

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