falImage to imageComing soon

fal-ai/image2pixel

fal-ai/image2pixel is an image to image tool from fal that runs in the background and returns images. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Price pending

Pricing

Price pending.

Limits

Runs
In the background
Returns
image
Longest queue wait
3600s
Run deadline
1800s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
image_url requiredURL or file—The image URL to process into improved pixel art
max_colorsnumber (whole)
1 to 256
32Maximum number of colors in the output palette. Set None to disable limit.
auto_color_detecttrue or falsefalseEnable automatic detection of optimal number of colors.
fixed_palettelist—Optional fixed color palette as hex strings (e.g., ['#000000', '#ffffff']).
detect_methodone of
auto, runs, edge
autoScale detection method to use.
scalenumber (whole)
1 to 64
—Force a specific pixel scale. If None, auto-detect.
downscale_methodone of
dominant, median, mode, mean, content-adaptive
dominantDownscaling method to produce the pixel-art output.
trim_borderstrue or falsefalseTrim borders of the image.
transparent_backgroundtrue or falsefalseRemove background of the image. This will check for contiguous color regions from the edges after correction and make them transparent.
cleanup_morphtrue or falsefalseApply morphological operations to remove noise.
cleanup_jaggytrue or falsefalseRemove isolated diagonal pixels (jaggy edge cleanup).
snap_gridtrue or falsetrueAlign output to the pixel grid.
alpha_thresholdnumber (whole)
0 to 255
128Alpha binarization threshold (0-255).
dominant_color_thresholdnumber
0 to 1
0.05Dominant color threshold (0.0-1.0).
background_tolerancenumber (whole)
0 to 255
0Background tolerance (0-255).
background_modeone of
edges, corners, midpoints
cornersControls where to flood-fill from when removing the background.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/image2pixel",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/image2pixel-input.jpg"
    }
  }'