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

# photos()

> 下载照片元数据

```python theme={null}
client.photos() -> pd.DataFrame
```

下载照片元数据，包括文件名、图像尺寸和 AI 生成的描述。

## 返回值

包含照片元数据的 `pd.DataFrame`。

## 示例

```python theme={null}
from jmail import JmailClient

client = JmailClient()
photos = client.photos()

# 描述中提到 "pool" 的照片
pool = photos[photos.image_description.str.contains("pool", case=False, na=False)]
```

## 列

| Column | Type | Description |
| - | - | - |
| `id` | int | 唯一照片编号 |
| `source` | string | 来源标识符 |
| `release_batch` | string | 卷/批次 |
| `original_filename` | string | 原始文件名 |
| `content_type` | string | MIME 类型 |
| `width` | int | 图像宽度（像素） |
| `height` | int | 图像高度（像素） |
| `image_description` | string | AI 生成的描述 |

## 直接 URL 地址

```
https://data.jmail.world/v1/photos.parquet
https://data.jmail.world/v1/photos.ndjson.gz
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.