falImage to imageComing soon

fal-ai/iclight-v2

fal-ai/iclight-v2 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.

Priced by usage

Pricing

$0.13 per megapixel. Each image_size preset counts as 1 MP, and a custom width × height rounds up to whole megapixels. Billed on num_images, default 1. The final charge comes from usage.

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
prompt requiredtext—The prompt to generate an image from.
negative_prompttextNegative Prompt for the image
image_url requiredURL or file—URL of image to be used for relighting
mask_image_urltext—URL of mask to be used for ic-light conditioning image
background_thresholdnumber
0.01 to 1
0.67Threshold for the background removal algorithm. A high threshold will produce sharper masks. Note: This parameter is currently deprecated and has no effect on the output.
image_sizeJSON—The size of the generated image.
num_inference_stepsnumber (whole)
1 to 50
28The number of inference steps to perform.
seednumber (whole)— The same seed and the same prompt given to the same version of the model will output the same image every time.
initial_latentone of
None, Left, Right, Top, Bottom
None Provide lighting conditions for the model
enable_hr_fixtrue or falsefalseUse HR fix
num_imagesnumber (whole)
1 to 4
1The number of images to generate.
cfgnumber
0.01 to 5
1The real classifier-free-guidance scale for the generation.
lowres_denoisenumber
0.01 to 1
0.98Strength for low-resolution pass.
highres_denoisenumber
0.01 to 1
0.95Strength for high-resolution pass. Only used if enable_hr_fix is True.
hr_downscalenumber
0.01 to 1
0.5
guidance_scalenumber
0 to 20
5 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.
output_formatone of
jpeg, png
jpegThe format of the generated image.

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/iclight-v2",
    "input": {
      "prompt": "perfume bottle in a volcano surrounded by lava.",
      "image_url": "https://storage.googleapis.com/falserverless/iclight-v2/bottle.png"
    }
  }'