GET
/v1/schemas/openai/image/images/variations
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace75476afd3f30a35ee8c98993f3570afc9d55be9fa8a3c2ba7b68b8b747fa7949{
"fetchedAt": 1791349881,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
6 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image* | string | The image to use as the basis for the variation(s). Must be a valid PNG file, less than 4MB, and square. | format: binary |
| model | string | enum | The legacy model used by the retired image variations endpoint. This endpoint no longer accepts requests. | nullable |
| n | any | The number of images to generate. Must be between 1 and 10. | 1 ≤ n ≤ 10 · default: 1 |
| response_format | enum | The 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" |
| size | enum | The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024`. | 256x256 | 512x512 | 1024x1024 | null · default: "1024x1024" |
| user | string | A 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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openai","endpointId":"images/variations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}