GET

/v1/schemas/fal/image/fal-ai/gpt-image-1/text-to-image

kind inputactivity imagehash 1b172c6a…extracted Oct 9, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

upstream-spec

Source trace
3729fba0e5fa4c1772f6031543ece96f58413d94bf9e897464c8376eaed9bcb1
{
  "fetchedAt": 1791522002,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

8 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt for image generationlength ≥ 2
num_imagesintegerNumber of images to generate1 ≤ n ≤ 4 · default: 1
image_sizeenumAspect ratio for the generated imageauto | 1024x1024 | 1536x1024 | 1024x1536 · default: "auto"
output_formatenumOutput format for the imagesjpeg | png | webp · default: "png"
backgroundenumBackground for the generated imageauto | transparent | opaque · default: "auto"
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true
qualityenumQuality for the generated imageauto | low | medium | high · default: "auto"
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false

Validate a payload

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