GET

/v1/schemas/openai/image/images%2Fvariations

kind inputactivity imagehash 4ffca4e0…extracted Nov 14, 2026version currentsource upstream spec ↗

Request body

6 properties · 1 required · 0 $defs
propertytypedescriptionconstraints
image*stringThe image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square.format: binary
modelstringThe legacy model used by the retired image variations endpoint. This endpoint no longer accepts requests.1 known values · nullable
nanyThe number of images to generate. Must be between 1 and 10.1 ≤ n ≤ 10 · default: 1
response_formatenumThe format in which the generated images are returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes after the image has been generated.url | b64_json | null · default: "url"
sizeenumThe size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`.256x256 | 512x512 | 1024x1024 | null · default: "1024x1024"
userstringA unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"openai","endpointId":"images/variations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}