elizaos--eliza/packages/docs/cloud/api/gallery.mdx

---
title: Gallery
description: Store and manage generated media on elizaOS Cloud.
---

# Gallery

View and manage your generated images and videos.

## List Gallery Items

<div className="api-endpoint">
  <span className="method-badge method-badge-get">GET</span>
  <span className="path">/api/v1/gallery</span>
</div>

Get all items in your gallery.

### Query Parameters

| Parameter | Type    | Description        |
| --------- | ------- | ------------------ |
| `type`    | string  | `image` or `video` |
| `limit`   | integer | Results per page   |
| `offset`  | integer | Pagination offset  |

### Response

```json
{
  "items": [
    {
      "id": "gal_abc123",
      "type": "image",
      "url": "https://your-storage.vercel-storage.com/images/abc123.png",
      "prompt": "A mountain landscape at sunset",
      "model": "google/nano-banana-2/text-to-image",
      "width": 1024,
      "height": 1024,
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 150
}
```

---

## Get Gallery Item

<div className="api-endpoint">
  <span className="method-badge method-badge-get">GET</span>
  <span className="path">/api/v1/gallery/{"{id}"}</span>
</div>

Get details about a specific item.

### Response

```json
{
  "id": "gal_abc123",
  "type": "image",
  "url": "https://your-storage.vercel-storage.com/images/abc123.png",
  "prompt": "A mountain landscape at sunset",
  "negativePrompt": "blurry, low quality",
  "model": "google/nano-banana-2/text-to-image",
  "width": 1024,
  "height": 1024,
  "seed": 12345,
  "cost": 0.02,
  "createdAt": "2024-01-15T10:30:00Z"
}
```

---

## Delete Gallery Item

<div className="api-endpoint">
  <span className="method-badge method-badge-delete">DELETE</span>
  <span className="path">/api/v1/gallery/{"{id}"}</span>
</div>

Delete an item from your gallery.

<Warning>Deleted items cannot be recovered.</Warning>

---

## Storage Limits

| Plan       | Storage   |
| ---------- | --------- |
| Free       | 1 GB      |
| Pro        | 50 GB     |
| Enterprise | Unlimited |

<Info>
  Gallery items are automatically deleted after 30 days on the free plan.
</Info>