GET

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

kind inputactivity imagehash a712b884extracted Jul 6, 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
modelstring | enumThe model to use for image generation. Only `dall-e-2` is supported at this time.default: "dall-e-2"
nintegerThe 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 · default: "url"
sizeenumThe size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`.256x256 | 512x512 | 1024x1024 · default: "1024x1024"
userstringA unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](/docs/guides/safety-best-practices#end-user-ids).

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", …}]}