falImage to imageComing soon

fal-ai/z-image/turbo/controlnet

Name: fal-ai/z-image/turbo/controlnet
Brand: fal

fal-ai/z-image/turbo/controlnet 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.00845 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` required	text	—	The prompt to generate an image from.
`image_size`	JSON	auto	The size of the generated image.
`num_inference_steps`	number (whole) 1 to 8	8	The number of inference steps to perform.
`seed`	number (whole)	—	The same seed and the same prompt given to the same version of the model will output the same image every time.
`num_images`	number (whole) 1 to 4	1	The number of images to generate.
`output_format`	one of jpeg, png, webp	png	The format of the generated image.
`acceleration`	one of none, regular, high	regular	The acceleration level to use.
`enable_prompt_expansion`	true or false	false	Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request.
`image_url` required	URL or file	—	URL of Image for ControlNet generation.
`control_scale`	number 0 to 1	0.75	The scale of the controlnet conditioning.
`control_start`	number 0 to 1	0	The start of the controlnet conditioning.
`control_end`	number 0 to 1	0.8	The end of the controlnet conditioning.
`preprocess`	one of none, canny, depth, pose	none	What kind of preprocessing to apply to the image, if any.

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/z-image/turbo/controlnet",
    "input": {
      "prompt": "A single leopard, its spotted golden coat detailed with black rosettes, cautiously peeks its head through dense green foliage. The leopard’s eyes are alert and…",
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/z-image-turbo-controlnet-input.jpg"
    }
  }'