Assets

Assets are the individual pieces of content that you index and search in Mixpeek. They can be text, images, videos, or any other supported content type. Each asset is processed to extract features and make it searchable.

​

Understanding Assets

​

Key Concepts

• Content Types: Different types of media content
• Feature Extraction: Automated processing and analysis
• Metadata: Additional information about assets
• Lifecycle Management: Asset creation to deletion

​

Asset Types

​

Supported Content

1. Text

   • Documents
   • Articles
   • Product descriptions
   • Social media posts

2. Images

   • Product photos
   • User uploads
   • Marketing materials
   • Artwork

3. Videos

   • Product demos
   • Tutorial content
   • Marketing videos
   • User-generated content

​

Best Practices

​

Asset Organization

1. Metadata Structure

   • Use consistent schemas
   • Include relevant information
   • Keep metadata current
   • Enable efficient filtering

2. Content Management

   • Validate content quality
   • Use appropriate formats
   • Optimize file sizes
   • Maintain content freshness

​

Performance Optimization

• Batch Processing: Process multiple assets together
• Efficient Updates: Use partial updates when possible
• Caching Strategy: Cache frequently accessed assets
• Resource Management: Monitor storage and processing

​

Asset URL Management

When retrieving assets, Mixpeek provides secure, temporary access through presigned URLs. This is controlled through the return_url parameter:

• Presigned URLs: Temporary, secure URLs that grant time-limited access to assets
• Access Control: Ensures assets are only accessible to authorized users
• Security: URLs automatically expire after a set period
• Performance: Enables direct asset downloads from storage without proxy routing

​

Example Response

When return_url: true is set, the API will return a presigned URL that looks like this:

{
  "asset_id": "b0a43750-af14-48fb-840f-f11a511c7198",
  "url": "https://mixpeek-api.s3.amazonaws.com/assets/ix-0Sqm__ZbVpAIHRkOJIyqEyhGEaNXs2dvY6WXJ6o6GkEzI0lXfR7S-qBimKKhI_OS8Bw/collection_id/b0a43750-af14-48fb-840f-f11a511c7198?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA5RWB335CYLLDSQHZ%2F20241206%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20241206T194101Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=d18f3a39a684b36fbe06199a7955adb68ec1c67f1e5ca74185de2c33d4c2ec81"
}

Let’s break down the URL components:

1. Base URL: https://mixpeek-api.s3.amazonaws.com/assets/...

   • Points to the storage location of the asset

2. Authentication Parameters:

   • X-Amz-Algorithm: Specifies the signing algorithm (AWS4-HMAC-SHA256)
   • X-Amz-Credential: AWS credentials used for signing
   • X-Amz-Date: Timestamp when the URL was generated
   • X-Amz-Expires: URL expiration time in seconds (3600 = 1 hour)
   • X-Amz-SignedHeaders: Headers included in signature calculation
   • X-Amz-Signature: Cryptographic signature ensuring URL authenticity

This URL will be valid for the specified expiration time (1 hour in this example) and can be used to directly download or access the asset.

​

Benefits

1. Security

   • Controlled access to sensitive assets
   • No need to expose permanent storage URLs
   • Automatic expiration reduces security risks

2. Performance

   • Direct downloads from storage providers
   • Reduced server load
   • Optimized for large files and media

3. Flexibility

   • Time-limited access for temporary sharing
   • Works with various storage backends
   • Supports both public and private assets