Image Model

Overview

ImageItem is the shared image object returned by BIB search and face search responses. ImageItemWithMeta extends it for All Photos and Image Details, where integrators often need source and upload metadata.

ImageItem

{
  "img_url": "https://photos.9pic.ai/imgs/456/large/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
  "height": 4860,
  "width": 3240,
  "image_id": "a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244",
  "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
  "original_url": null
}

Field	Type	Description
`img_url`	string	Large image URL.
`height`	number \| null	Image height in pixels.
`width`	number \| null	Image width in pixels.
`image_id`	string	Image UUID.
`thumbnail_url`	string	Thumbnail image URL.
`original_url`	string \| null	Original (unwatermarked) image URL when directly available; otherwise `null`. To fetch presigned download links for originals, call Download Original Photos.

ImageItemWithMeta

Returned by All Photos and Image Details.

{
  "img_url": "https://photos.9pic.ai/imgs/456/large/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
  "height": 4860,
  "width": 3240,
  "image_id": "a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244",
  "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
  "original_url": null,
  "meta_info": {
    "photo_timestamp": 1700000000,
    "photographer_name": "photographer-a",
    "original_file_name": "IMG_0001.JPG",
    "source": "9Pic storage",
    "image_path": "456/photographer-a/originals/IMG_0001.JPG"
  }
}

Field	Type	Description
`img_url`	string	Large image URL.
`height`	number \| null	Image height in pixels.
`width`	number \| null	Image width in pixels.
`image_id`	string	Image UUID.
`thumbnail_url`	string	Thumbnail image URL.
`original_url`	string \| null	Original (unwatermarked) image URL when directly available; otherwise `null`.
`meta_info`	object	Curated metadata for the photo: capture timestamp, uploader/photographer folder when available, original filename, public source label, image path, and Google Drive link when applicable.

meta_info

meta_info is intentionally curated. It does not expose the full internal processing payload.

Field	Type	Description
`photo_timestamp`	number \| null	Capture/order timestamp from the event photo mapping.
`photographer_name`	string \| null	Photographer folder inferred from 9Pic upload paths.
`original_file_name`	string \| null	Original filename stored during image import.
`source`	string \| null	Public import source label, such as `9Pic storage` or `Google Drive`.
`image_path`	string \| null	Image path or source-specific image identifier.
`google_drive_link`	string	Present only when the image source is Google Drive.

Used By

All Photos

Returns data.images[] as metadata-enriched image objects.

Image Details

Returns one ImageItem as data.

BIB Search

Returns matching data.images[] as image objects.

Face Search

Returns matching data.images[] as image objects.

Get Started

Events

Memories

Browse Photos

Search

Video

Downloads

Pipeline

Models

Overview

ImageItem

ImageItemWithMeta

meta_info

Used By

All Photos

Image Details

BIB Search

Face Search

​Overview

​ImageItem

​ImageItemWithMeta

​meta_info

​Used By

All Photos

Image Details

BIB Search

Face Search

Overview

ImageItem

ImageItemWithMeta

meta_info

Used By