> ## 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 | 一意の写真ID |
| `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.