falImage to imageComing soon

fal-ai/hunyuan-image/v3/instruct/edit

fal-ai/hunyuan-image/v3/instruct/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.

Priced by usage

Pricing

$0.117 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 text prompt to generate an image from.
image_sizeJSONautoThe desired size of the generated image. If auto, image size will be determined by the model.
num_imagesnumber (whole)
1 to 4
1The number of images to generate.
guidance_scalenumber
… to 20
3.5Controls how much the model adheres to the prompt. Higher values mean stricter adherence.
enable_prompt_expansiontrue or falsetrueIf set to true, the prompt will be expanded through the model's internal recaptioning step.
seednumber (whole)—Random seed for reproducible results. If None, a random seed is used.
output_formatone of
jpeg, png
pngThe format of the generated image.
image_urls requiredURLs or files—The URLs of the images to use as a reference for the generation. A maximum of 3 images are supported.

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/hunyuan-image/v3/instruct/edit",
    "input": {
      "prompt": "Turn this artwork into a realistic image",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'