GET

/v1/schemas/vercel/image/images/generations?kind=output

kind outputactivity imagehash 2bb01660…extracted Nov 14, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.

generated

Source trace
bcb294f667de4a8a7371eb0f2b984e393a86ccce9e2cef297d770325ffadebbb
{
  "fetchedAt": 1794634255,
  "extractorVersion": "2",
  "verifiedAt": null
}

Response body

9 properties · 1 required · 6 $defs
propertytypedescriptionconstraints
created*integerThe Unix timestamp (in seconds) of when the image was created.format: unixtime
safety_identifieranyThe 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.
dataImage[]The list of generated images.
backgroundenumThe background parameter used for the image generation. Either `transparent` or `opaque`.transparent | opaque
output_formatenumThe output format of the generated or edited image.png | webp | jpeg | gif | svg
sizestring | enumThe image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
qualityenumThe quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or `max`.low | medium | high | xhigh | max
usageImageGenUsageToken usage information for image generation with GPT Image models.
svg_usageSvgUsageToken usage for SVG authoring, separate from image rendering usage.

Types

6 $defs

Imageobject

Represents the content or the URL of an image generated by the OpenAI API.

b64_jsonstringThe 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.
urlstringThe 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_promptstringThe 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*integerThe number of text tokens in the input prompt.
image_tokens*integerThe number of image tokens in the input prompt.

ImageGenOutputTokensDetailsobject

The output token details for the image generation.

image_tokens*integerThe number of image output tokens generated by the model.
text_tokens*integerThe number of text output tokens generated by the model.

ImageGenUsageobject

Token usage information for image generation with GPT Image models.

input_tokens*integerThe number of tokens (images and text) in the input prompt.
total_tokens*integerThe total number of tokens (images and text) used for the image generation.
output_tokens*integerThe number of output tokens generated by the model.
output_tokens_detailsImageGenOutputTokensDetailsThe output token details for the image generation.
input_tokens_details*ImageGenInputUsageDetailsThe input tokens detailed information for the image generation.

ImagesApiOutputFormatenum

png | webp | jpeg | gif | svg

SvgUsageobject

model*string
input_tokens*integer
output_tokens*integer
total_tokens*integer
reasoning_tokens*integer

Validate a payload

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