Skip to main content

​
What is Aspect?

Aspect Media Engine is an API + SDK that turns raw media into structured, searchable data. Upload assets, run AI features like transcription and embeddings, stream optimized proxies/previews, and analyze images with simple calls.

Sign up & get an API key

Create an account and grab your API key to authenticate requests.

Quickstart

Ingest your first asset and run search/analysis in minutes.

API reference

Explore endpoints, payloads, and responses.

SDK reference

Explore endpoints, payloads, and responses.

​
Upload and search in minutes

import { Aspect } from 'aspect-sdk'

const client = new Aspect({
  apiKey: 'YOUR_API_KEY'
})

// Create a place to organize assets
const index = await client.indexes.create({
  name: 'Getting Started',
  features: ['visual']
})

// Add a video from a file path
const { assetId } = await client.assets.create({
  indexId: index.id,
  name: 'video.mp4',
  assetFile: '/path/to/video.mp4',
  features: ['transcription'],
  saveOriginal: true,
})

// Search your indexed content
const results = await client.search.run({
  indexId: index.id,
  query: "your-search-query",
})
console.log(results)

​
Core flows

Create an index

Organize assets and set default features.

Upload assets

Add videos, images, or audio with a file or URL.

Run tasks

Queue transcription or embeddings and track progress.

Analyze images

Ask, point, or box queries for image understanding.

API reference

Explore endpoints and schemas.

​
Next steps

Node.js SDK

Install and use the Node.js SDK.

Python SDK

Install and use the Python SDK.

Core concepts

Learn indexes, assets, features, and tasks.

Webhooks

Receive task updates in your app.