Skip to main content
Hero Light

​
Welcome to Memory API

A unified API for managing memory buckets and uploading multimodal content (videos, images, URLs, and text) with powerful semantic search capabilities.

​
Key Features

Memory Buckets

Create and manage isolated memory buckets to organize your content

Multimodal Upload

Single endpoint for videos, images, URLs, and text memories

Powerful Search

Search within single or multiple buckets using natural language

Semantic Search

Advanced AI-powered search across videos, images, and text memories

​
Quick Start

​
1. Create a Memory Bucket

curl -X POST "https://api.your-domain.com/memory-bucket/create" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Memories",
    "description": "Personal collection"
  }'

​
2. Upload Content

# Upload a video file
curl -X POST "https://api.your-domain.com/upload" \
  -F "[email protected]" \
  -F "unique_id=your-bucket-id"

# Or upload text memory
curl -X POST "https://api.your-domain.com/upload" \
  -F "memory=Meeting with the team today" \
  -F "unique_id=your-bucket-id" \
  -F "tags=[\"work\", \"meeting\"]"

​
3. Search Your Content

curl -X POST "https://api.your-domain.com/search" \
  -H "Content-Type: application/json" \
  -d '{
    "search_param": "team meeting",
    "unique_id": "your-bucket-id",
    "top_k": 5
  }'

​
API Endpoints

The API provides 5 core endpoints:
  1. POST /memory-bucket/create - Create a new memory bucket
  2. POST /memory-bucket/delete - Delete an existing bucket
  3. POST /upload - Upload any content type (multimodal)
  4. POST /search - Search within a single bucket
  5. POST /search/multiple - Search across multiple buckets

​
Environment Setup

Set your API key: 
MEMORY_API_KEY=your_api_key_here

​
Get Started

Explore the API endpoints in the sidebar to learn more about each feature.