GET
/v1/schemas/fal/image/fal-ai/z-image/turbo/tiling
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracecef18aa0e272067880c4adf0976defc8d6c869f05df88eec1b6580886ac1e9aa{
"fetchedAt": 1788670830,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
16 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to generate an image from. | |
| seed | integer | The same seed and the same prompt given to the same version of the model will output the same image every time. | nullable |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "png" |
| strength | number | How much to transform the input image. Only used when image_url is provided. | 0 < n ≤ 1 · default: 0.6 |
| image_url | string | URL of an image for image-to-image or inpainting. When provided without mask_image_url, performs image-to-image; with mask_image_url, performs inpainting. | nullable |
| acceleration | enum | The acceleration level to use. | none | regular | high · default: "regular" |
| tiling_mode | enum | Tiling direction: 'both' (omnidirectional), 'horizontal' (left-right only), 'vertical' (top-bottom only). | both | horizontal | vertical · default: "both" |
| tile_size | integer | Tile size in latent space. Must be even (divisible by 2) for patchification. Automatically capped to the generated image dimensions on tiled axes. (64 = 512px, 128 = 1024px, 256 = 2048px). | 32 ≤ n ≤ 256 · default: 128 |
| num_inference_steps | integer | The number of inference steps to perform. | 1 ≤ n ≤ 8 · default: 8 |
| mask_image_url | string | URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url. | nullable |
| num_images | integer | The number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| 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 |
| tile_stride | integer | Tile stride in latent space. Must be even (divisible by 2). Automatically capped to half the effective tile size. (32 = 256px, 64 = 512px, 128 = 1024px). | 16 ≤ n ≤ 128 · default: 64 |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images. | default: true |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request. | default: false |
| image_size | ImageSize | enum | The size of the generated image. Use 'auto' to match the input image size (or 1024x1024 if no image). | default: "square_hd" |
Types
1 $defsImageSizeobject
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/z-image/turbo/tiling","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}