GET
/v1/schemas/fal/image/ideogram/v4.6
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace5ff5bd22e328889f153baef03b4ffabce491f5526158120f31e57803c7fc21a5{
"fetchedAt": 1795150801,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
9 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The generation or editing prompt. | length ≥ 1 · length ≤ 10000 |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| enable_prompt_expansion | boolean | Enable partner prompt expansion. | default: true |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 8 · default: 1 |
| sync_mode | boolean | Return image data directly in the response. | default: false |
| background | enum | transparent returns an image with an alpha channel; opaque forces a solid background. Leave unset for the model default. | transparent | opaque · nullable |
| seed | integer | Random seed. Omit to choose automatically. | nullable |
| image_size | ImageSize | enum | Output size. auto lets the model pick a size of about 2K. Named presets use standard fal dimensions. Explicit dimensions must be at least 256 per side, multiples of 32, at most 4096 per side, with an aspect ratio within 1:6 and 6:1. Outputs larger than 2048x20… | default: "auto" |
| quality | enum | Text-to-image quality. very_low renders at most 2K, so it rejects an explicit image_size larger than 2048x2048 in area. | very_low | low | medium | high · default: "medium" |
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":"ideogram/v4.6","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}