falImage to imageComing soon

fal-ai/uso

Name: fal-ai/uso
Brand: fal

fal-ai/uso 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

Field	Kind	Default	Description
`prompt`	text		Text prompt for generation. Can be empty for pure style transfer.
`input_image_urls` required	list	—	List of image URLs in order: [content_image, style_image, extra_style_image].
`image_size`	JSON	square_hd	The size of the generated image.
`negative_prompt`	text		What you don't want in the image. Use it to exclude unwanted elements, styles, or artifacts.
`num_inference_steps`	number (whole) 1 to 50	28	Number of denoising steps. More steps can improve quality but increase generation time.
`guidance_scale`	number 1 to 10	4	How closely to follow the prompt. Higher values stick closer to the prompt.
`keep_size`	true or false	false	Preserve the layout and dimensions of the input content image. Useful for style transfer.
`num_images`	number (whole) 1 to 4	1	Number of images to generate in parallel.
`seed`	number (whole)	—	Random seed for reproducible generation. Use same seed for consistent results.
`output_format`	one of jpeg, png	png	Output image format. PNG preserves transparency, JPEG is smaller.

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/uso",
    "input": {
      "input_image_urls": [
        "<input_image_urls>"
      ]
    }
  }'