GET
/v1/schemas/fal/image/xai/grok-imagine-image/v2.0/edit
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace4058b7dc17c1aef9d0ee3b0deab6ae9ca71d8f9742cf70064cdacae3dfd04bf6{
"fetchedAt": 1793250001,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text description of the desired image. | length ≤ 8000 |
| 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 |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| image_urls | string[] | List of URLs of the images to edit. A maximum of 5 images are supported. | |
| output_format | enum | The format of the generated image. | jpeg | png | webp · default: "jpeg" |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 10 · default: 1 |
| aspect_ratio | enum | Aspect ratio of the edited image. Standard auto uses the nearest supported ratio of the first reference. | 2:1 | 20:9 | 19.5:9 | 16:9 | 4:3 | 3:2 · +10 more · default: "auto" |
| resolution | enum | Resolution of the generated image: 1k, 1.5k, or 2k. | 1k | 1.5k | 2k · default: "1k" |
| quality | enum | Quality level of the edited image. `auto` lets xAI choose; it currently uses `medium` for editing. | low | medium | auto · default: "medium" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"xai/grok-imagine-image/v2.0/edit","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}