GET

/v1/schemas/fal/image/fal-ai/bytedance/dreamina/v3.1/text-to-image

Accept:

kind inputactivity imagehash 2b395f16…extracted Jul 6, 2026version currentsource upstream spec ↗

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

Request body

6 properties · 1 required · 1 $defs

property	type	description	constraints
prompt*	string	The text prompt used to generate the image
num_images	integer	Number of images to generate	1 ≤ n ≤ 4 · default: 1
enhance_prompt	boolean	Whether to use an LLM to enhance the prompt	default: false
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
image_size	ImageSize \| enum	The size of the generated image. Width and height must be between 512 and 2048.	default: {"height":1536,"width":2048}
seed	integer	Random seed to control the stochasticity of image generation.	nullable

Types

1 $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

Validate a payload

before you spend tokens

shell

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