GET
/v1/schemas/vercel/image/images/generations?kind=output
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. generated Source trace898eefefea6b5dc52da42f5628a64a0ffba65d850282e1cb59ab459f7e356f92{
"fetchedAt": 1793856100,
"extractorVersion": "1",
"verifiedAt": null
} |
Response body
9 properties · 1 required · 4 $defs| property | type | description | constraints |
|---|---|---|---|
| created* | integer | The Unix timestamp (in seconds) of when the image was created. | format: unixtime |
| svg_usage | object | Token usage for the model that authored the SVG, separate from image rendering usage. | |
| safety_identifier | any | The effective safety identifier used for safety monitoring and abuse detection. This is the non-empty `safety_identifier` from the request, or the deprecated `user` value when `safety_identifier` is omitted, null, or empty. | |
| data | Image[] | The list of generated images. | |
| background | enum | The background parameter used for the image generation. Either `transparent` or `opaque`. | transparent | opaque |
| output_format | enum | The output format of the generated image. | png | webp | jpeg | gif | svg |
| size | string | enum | The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`. | |
| quality | enum | The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or `max`. | low | medium | high | xhigh | max |
| usage | ImageGenUsage | For `gpt-image-1` only, the token usage information for the image generation. |
Types
4 $defsImageobject
Represents the content or the URL of an image generated by the OpenAI API.
| b64_json | string | The base64-encoded JSON of the generated image. Returned by default for GPT image models, or when `response_format` is set to `b64_json` for models that support that parameter. | |
| url | string | The URL of the generated image when `response_format` is set to `url` for models that support that parameter. Unsupported for GPT image models. | format: uri |
| revised_prompt | string | The revised prompt used to generate the image, for models that support prompt revision. Not returned by GPT image models. |
ImageGenInputUsageDetailsobject
The input tokens detailed information for the image generation.
| text_tokens* | integer | The number of text tokens in the input prompt. | |
| image_tokens* | integer | The number of image tokens in the input prompt. |
ImageGenOutputTokensDetailsobject
The output token details for the image generation.
| image_tokens* | integer | The number of image output tokens generated by the model. | |
| text_tokens* | integer | The number of text output tokens generated by the model. |
ImageGenUsageobject
For `gpt-image-1` only, the token usage information for the image generation.
| input_tokens* | integer | The number of tokens (images and text) in the input prompt. | |
| total_tokens* | integer | The total number of tokens (images and text) used for the image generation. | |
| output_tokens* | integer | The number of output tokens generated by the model. | |
| output_tokens_details | ImageGenOutputTokensDetails | The output token details for the image generation. | |
| input_tokens_details* | ImageGenInputUsageDetails | The input tokens detailed information for the image generation. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"vercel","endpointId":"images/generations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}