GET
/v1/schemas/fal/image/fal-ai/hidream-o1-image/dev/edit
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace91bcfea281e44ba7873343b165c2f75034a1c2277c4ba4d089e133e6b6d82be5{
"fetchedAt": 1783330412,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
11 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text prompt for image generation, editing, or subject-driven personalization. | length ≥ 1 |
| reference_image_urls* | string[] | Reference images for image editing or subject-driven personalization. | items ≥ 1 |
| 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 |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| keep_original_aspect | boolean | When exactly one reference image is provided, preserve its aspect ratio for the output image. | default: false |
| seed | integer | Random seed for reproducible generation. | nullable |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "png" |
| image_size | ImageSize | enum | Requested output image size. Reference-image outputs use the nearest model-supported resolution up to about 2048x2048 pixels. | default: {"height":2048,"width":2048} |
| guidance_scale | number | Classifier-free guidance scale. The dev model uses 0.0 by default. | 0 ≤ n ≤ 20 · default: 0 |
| enable_safety_checker | boolean | Enable the safety checker on generated images. | default: true |
| num_inference_steps | integer | Number of denoising steps. The dev model is distilled for 28 steps. | 1 ≤ n ≤ 28 · default: 28 |
Types
1 $defsImageSizeobject
| 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 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/hidream-o1-image/dev/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}