GET
/v1/schemas/fal/image/fal-ai/ip-adapter-face-id
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace36d3b7c81cf00cd6d1acd5f752e44fefbe5a880fb1cf2a35d4f67441b1f352d4{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
15 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to use for generating the image. Be as descriptive as possible for best results. | |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| 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: "blurry, low resolution, bad, ug… |
| 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 |
| width | integer | The width of the generated image. | 512 ≤ n ≤ 1024 · default: 512 |
| face_id_det_size | integer | The size of the face detection model. The higher the number the more accurate the detection will be but it will also take longer to run. The higher the number the more likely it will fail to find a face as well. Lower it if you are having trouble finding a fac… | 64 ≤ n ≤ 640 · default: 640 |
| num_inference_steps | integer | The number of inference steps to use for generating the image. The more steps the better the image will be but it will also take longer to generate. | 1 ≤ n ≤ 200 · default: 50 |
| num_samples | integer | The number of samples for face id. The more samples the better the image will be but it will also take longer to generate. Default is 4. | 1 ≤ n ≤ 4 · default: 4 |
| base_1_5_model_repo | string | The URL to the base 1.5 model. Default is SG161222/Realistic_Vision_V4.0_noVAE | default: "SG161222/Realistic_Vision_V4.0_… |
| height | integer | The height of the generated image. | 512 ≤ n ≤ 1024 · default: 512 |
| model_type | enum | The model type to use. 1_5 is the default and is recommended for most use cases. | 1_5-v1 | 1_5-v1-plus | 1_5-v2-plus | SDXL-v1 | SDXL-v2-plus | 1_5-auraface-v1 · default: "1_5-v1" |
| face_image_url | string | An image of a face to match. If an image with a size of 640x640 is not provided, it will be scaled and cropped to that size. | nullable |
| 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. | 0 ≤ n ≤ 16 · default: 7.5 |
| base_sdxl_model_repo | string | The URL to the base SDXL model. Default is SG161222/RealVisXL_V3.0 | default: "SG161222/RealVisXL_V3.0" |
| face_images_data_url | string | URL to zip archive with images of faces. The images embedding will be averaged to create a more accurate face id. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/ip-adapter-face-id","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}