GET

/v1/schemas/fal/image/fal-ai/hidream-o1-image/edit

kind inputactivity imagehash 6ed9472e…extracted Jul 6, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
caf36f5e75eda56d6f570d294d22f298b67ce5a115c37ff79456c64fad78db0e
{
  "fetchedAt": 1783329487,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

11 properties · 2 required · 1 $defs
propertytypedescriptionconstraints
reference_image_urls*string[]Reference images for image editing or subject-driven personalization.items ≥ 1
prompt*stringText prompt for image generation, editing, or subject-driven personalization.length ≥ 1
guidance_scalenumberClassifier-free guidance scale. The full model uses 5.0 by default.0 ≤ n ≤ 20 · default: 5
num_imagesintegerNumber of images to generate.1 ≤ n ≤ 4 · default: 1
image_sizeImageSize | enumRequested output image size. Reference-image outputs use the nearest model-supported resolution up to about 2048x2048 pixels.default: {"height":2048,"width":2048}
enable_safety_checkerbooleanEnable the safety checker on generated images.default: true
keep_original_aspectbooleanWhen exactly one reference image is provided, preserve its aspect ratio for the output image.default: false
output_formatenumThe format of the generated image.jpeg | png | webp · default: "png"
seedintegerRandom seed for reproducible generation.nullable
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
num_inference_stepsintegerNumber of denoising steps.1 ≤ n ≤ 50 · default: 50

Types

1 $defs

ImageSizeobject

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

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/hidream-o1-image/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}