GET
/v1/schemas/fal/image/openai/gpt-image-2.5/flare/text-to-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracee170b7dc6f6661885b0a23aa524875cf22c9acb075b39e568c6f21dfd9464e51{
"fetchedAt": 1793250001,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt for image generation | length ≥ 1 · length ≤ 32000 |
| output_format | enum | Output format for the images | jpeg | png | webp · default: "png" |
| quality | enum | Quality for the generated image. Higher settings increase detail, latency, and token usage. Use 'auto' to let the model choose. | auto | low | medium | high | xhigh | max · default: "high" |
| image_size | ImageSize | enum | The size of the generated image. Supports preset names, explicit {width, height}, or 'auto' to let the model pick the best size. Concrete sizes must have both dimensions as multiples of 16, max edge 3840px, aspect ratio <= 3:1, total pixels between 655,360 and… | default: "landscape_4_3" |
| 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 |
| background | enum | Background for the generated image | auto | transparent | opaque · default: "auto" |
| num_images | integer | Number of images to generate | 1 ≤ n ≤ 10 · default: 1 |
| output_compression | integer | Compression level from 0 to 100. Only supported when output_format is 'jpeg' or 'webp'. | 0 ≤ n ≤ 100 · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
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":"openai/gpt-image-2.5/flare/text-to-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}