GET

/v1/schemas/fal/image/ideogram/v4/instant

kind inputactivity imagehash 729252fc…extracted Aug 10, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
5b58a3eb80a7f926f559f1f21cbf31ff91037fa4a1be89f1d9f9076ea46f5e58
{
  "fetchedAt": 1786338105,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

8 properties · 1 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to generate an image from.
sync_modebooleanIf `True`, the image is returned as a data URI and is not stored.default: false
output_formatenumThe format of the generated image.jpeg | png · default: "jpeg"
seedintegerThe seed to use for generation. If not provided, a random seed will be used.nullable
num_imagesintegerNumber of images to generate.1 ≤ n ≤ 4 · default: 1
image_sizeImageSize | enumThe resolution of the generated image.default: "square_hd"
expansion_modelenumWhich model expands the prompt. 'None' disables expansion; 'Medium' uses the fast magic prompt model.None | Medium · default: "Medium"
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.default: true

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":"ideogram/v4/instant","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}