Skip to content

GenerativeUiComponentImage

HTTP API schema

A2UI `Image`. The TV fetches the image from `url` (https only; no inline data), at a fixed size per `variant`. It uses the card radius, shows the surface color while loading and a muted placeholder if the image fails, so a broken URL never leaves a hole.

GenerativeUiComponentImage fields

idstringRequired

Unique id in the surface.

minLength: 1

componentstringRequired

pattern: "^Image$"

fitstring

How the image is resized into its box.

Default: fill

Allowed values

  • contain
  • cover
  • fill
  • none
  • scaleDown
variantstring

Image size and style. The TV gives each variant a fixed size.

Default: mediumFeature

Allowed values

  • icon
  • avatar
  • smallFeature
  • mediumFeature
  • largeFeature
  • header
weightnumber

Share of the free space in the parent `Row` or `Column`.

minimum: 0

exclusiveMinimum: true

View source specification ↗