GET
/v1/schemas/fal/image/fal-ai/phota/edit
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracec8415bc05e45cf811e1853c1aa7b0a452623e524f077717ce517cc180269885e{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text description of the desired image. To refer to specific profiles, use [[profile_id_1]], [[profile_id_2]], etc. | length ≤ 8000 |
| image_urls* | string[] | List of URLs/ Base64 data URIs of the images to edit. At least one image is required; for pure text-to-image generation use the `/` endpoint instead. A maximum of 10 images are supported, additional images will be ignored. | items ≥ 1 |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| base_model | enum | Base 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_ratio | enum | Aspect ratio of the generated image. | auto | 1:1 | 16:9 | 4:3 | 3:4 | 9:16 · default: "auto" |
| output_format | enum | The format of the generated image. | jpeg | png · default: "jpeg" |
| 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 |
| resolution | enum | Resolution of the generated image. | 1K | 4K · default: "1K" |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| profile_ids | string[] | List of profile IDs to use for the image generation. Profiles may be tagged in the prompt as @Profile1, @Profile2, etc. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/phota/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}