GET

/v1/schemas/fal/image/fal-ai/hidream-i1-full/image-to-image

Accept:

kind inputactivity imagehash be724481…extracted Aug 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `1f63ddce9dd7331c4d7a430d544e4b91b72701be79ab081366f011c0c67101ae` { "fetchedAt": 1786338105, "extractorVersion": "1", "verifiedAt": null }

Request body

13 properties · 2 required · 2 $defs

property	type	description	constraints
prompt*	string	The prompt to generate an image from.
image_url*	string	The image URL to generate an image from.
guidance_scale	number	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.	0 ≤ n ≤ 20 · default: 5
num_images	integer	The number of images to generate.	1 ≤ n ≤ 4 · default: 1
num_inference_steps	integer	The number of inference steps to perform.	1 ≤ n ≤ 50 · default: 50
enable_safety_checker	boolean	If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images.	default: true
seed	integer	The same seed and the same prompt given to the same version of the model will output the same image every time.	nullable
strength	number	Denoising strength for image-to-image generation.	0 ≤ n ≤ 1 · default: 0.75
image_size	ImageSize \| enum	The size of the generated image. Setting to None uses the input image's size.	nullable
output_format	enum	The format of the generated image.	jpeg \| png · default: "jpeg"
negative_prompt	string	The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).	default: ""
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	default: false
loras	LoraWeight[]	A list of LoRAs to apply to the model. Each LoRA specifies its path, scale, and optional weight name.	nullable

Types

2 $defs

ImageSizeobject

height	integer	The height of the generated image.	0 < n ≤ 14142 · default: 512
width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512

LoraWeightobject

weight_name	string	Name of the LoRA weight. Used only if `path` is a Hugging Face repository, and required only if you have more than 1 safetensors file in the repo.	nullable
path*	string	URL or the path to the LoRA weights.
scale	number	The scale of the LoRA weight. This is used to scale the LoRA weight before merging it with the base model.	0 ≤ n ≤ 4 · default: 1

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/hidream-i1-full/image-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}