falImage to imageComing soon

fal-ai/phota/edit

fal-ai/phota/edit 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
prompt requiredtext—Text description of the desired image. To refer to specific profiles, use [[profile_id_1]], [[profile_id_2]], etc.
num_imagesnumber (whole)
1 to 4
1Number of images to generate.
profile_idslist—List of profile IDs to use for the image generation. Profiles may be tagged in the prompt as @Profile1, @Profile2, etc.
output_formatone of
jpeg, png
jpegThe format of the generated image.
resolutionone of
1K, 4K
1KResolution of the generated image.
aspect_ratioone of
auto, 1:1, 16:9, 4:3, 3:4, 9:16
autoAspect ratio of the generated image.
base_modelone of
nb2, qwen-image-2, flux-2, seedream-5-pro
nb2Base model used to render the image. Identity composes on top of whichever base model is selected, so trained profiles work with all of them. Only `nb2` supports `4K`.
image_urls requiredURLs or files—List of URLs/ Base64 data URIs of the images to edit. At least one image is required; for pure text-to-image generation use the `/` endpoint instead. A maximum of 10 images are supported, additional images will be ignored.

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/phota/edit",
    "input": {
      "prompt": "Make this scene more realistic but still keep the game vibes",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'