GET
/v1/schemas/fal/image/fal-ai/hidream-o1-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracec3860d34a99ab1386eb4a6ef9a4760db1ccc7c35bb7b81e7240aeb7e01f3a274{
"fetchedAt": 1783329487,
"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 |
| reference_image_urls | string[] | Optional reference images. Use none for text-to-image, one for image editing, or multiple for subject-driven personalization. | default: [] |
| guidance_scale | number | Classifier-free guidance scale. The full model uses 5.0 by default. | 0 ≤ n ≤ 20 · default: 5 |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 4 · default: 1 |
| 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} |
| enable_safety_checker | boolean | Enable the safety checker on generated images. | default: true |
| keep_original_aspect | boolean | When exactly one reference image is provided, preserve its aspect ratio for the output image. | default: false |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "png" |
| seed | integer | Random seed for reproducible generation. | nullable |
| 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_inference_steps | integer | Number of denoising steps. | 1 ≤ n ≤ 50 · default: 50 |
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","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}