GET
/v1/schemas/fal/image/fal-ai/hidream-o1-image/dev
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracefaa060ed761401e14573c3c16c6ac3083789e86fc49de842d04ba8761b63ef94{
"fetchedAt": 1783330412,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
11 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text prompt for image generation, editing, or subject-driven personalization. | length ≥ 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 |
| reference_image_urls | string[] | Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization. | default: [] |
| 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. Dimensions are rounded down to a multiple of 32, up to about 2048x2048 pixels. | default: {"height":1024,"width":1024} |
| 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","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}