> ## Documentation Index
> Fetch the complete documentation index at: https://docs.9pic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Model

> Shared photo object returned by photo list and search APIs

## Overview

`ImageItem` is the shared image object returned by the all-photos, BIB search, and face search responses. The same shape is reused regardless of how the photo was discovered, so you can render any of them through one component.

## ImageItem

```json theme={null}
{
  "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](/api-reference/download-original-photos). |

## Used By

<CardGroup cols={2}>
  <Card title="All Photos" icon="images" href="/api-reference/all-photos">
    Returns `data.images[]` as image objects.
  </Card>

  <Card title="BIB Search" icon="hashtag" href="/api-reference/bib-search">
    Returns matching `data.images[]` as image objects.
  </Card>

  <Card title="Face Search" icon="user-magnifying-glass" href="/api-reference/face-search">
    Returns matching `data.images[]` as image objects.
  </Card>
</CardGroup>