GET
/v1/schemas/fal/image/fal-ai/image2pixel
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace570244531544bbe3689370d79c8ab7cb54c3cdc1e86f676aa2da65a4f2003191{
"fetchedAt": 1783330412,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
17 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | The image URL to process into improved pixel art | |
| dominant_color_threshold | number | Dominant color threshold (0.0-1.0). | 0 ≤ n ≤ 1 · default: 0.05 |
| trim_borders | boolean | Trim borders of the image. | default: false |
| detect_method | enum | Scale detection method to use. | auto | runs | edge · default: "auto" |
| downscale_method | enum | Downscaling method to produce the pixel-art output. | dominant | median | mode | mean | content-adaptive · default: "dominant" |
| 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 |
| fixed_palette | string[] | Optional fixed color palette as hex strings (e.g., ['#000000', '#ffffff']). | nullable |
| cleanup_morph | boolean | Apply morphological operations to remove noise. | default: false |
| alpha_threshold | integer | Alpha binarization threshold (0-255). | 0 ≤ n ≤ 255 · default: 128 |
| scale | integer | Force a specific pixel scale. If None, auto-detect. | 1 ≤ n ≤ 64 · nullable |
| auto_color_detect | boolean | Enable automatic detection of optimal number of colors. | default: false |
| snap_grid | boolean | Align output to the pixel grid. | default: true |
| cleanup_jaggy | boolean | Remove isolated diagonal pixels (jaggy edge cleanup). | default: false |
| max_colors | integer | Maximum number of colors in the output palette. Set None to disable limit. | 1 ≤ n ≤ 256 · nullable |
| background_tolerance | integer | Background tolerance (0-255). | 0 ≤ n ≤ 255 · default: 0 |
| background_mode | enum | Controls where to flood-fill from when removing the background. | edges | corners | midpoints · default: "corners" |
| transparent_background | boolean | Remove background of the image. This will check for contiguous color regions from the edges after correction and make them transparent. | default: false |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/image2pixel","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}