Video Management

The Vision API provides comprehensive video management capabilities for uploading, retrieving, and organizing your video content.

Upload Videos

Upload videos using either a file upload or a URL:

$
curl -X POST https://vision-agent.api.reka.ai/videos/upload \
>
  -H "X-Api-Key: YOUR_API_KEY" \
>
  -F "file=@video.mp4" \
>
  -F "video_name=my_video.mp4" \
>
  -F "index=true"

Upload Parameters

• file (optional): Video file to upload (mutually exclusive with video_url)
• video_url (optional): URL of the video to upload (mutually exclusive with file)
• video_name (required): Name for the video
• video_absolute_start_timestamp (optional): ISO 8601 timestamp
• index (required): Whether to index the video for search and Q&A

Get Videos

Retrieve specific videos by their IDs:

$
curl -X POST https://vision-agent.api.reka.ai/videos/get \
>
  -H "X-Api-Key: YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "video_ids": ["550e8400-e29b-41d4-a716-446655440000"]
>
  }'

List Videos

List all your videos with optional filtering:

$
curl -X POST https://vision-agent.api.reka.ai/videos/get \
>
  -H "X-Api-Key: YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \

Delete Videos

Delete videos by their IDs:

$
curl -X DELETE https://vision-agent.api.reka.ai/videos/delete \
>
  -H "X-Api-Key: YOUR_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "video_ids": ["550e8400-e29b-41d4-a716-446655440000"]
>
  }'

Video Response Format

Each video response includes:

• video_id: Unique identifier
• url: Presigned S3 URL for access
• indexing_status: Current indexing status (pending, indexing, indexed, failed)
• metadata: Video metadata (dimensions, duration, timestamps, etc.)
• indexing_type: Type of indexing applied

Indexing Status

• pending: Video uploaded, indexing not started
• indexing: Video is currently being processed
• indexed: Video has been successfully indexed and is ready for search/Q&A
• failed: Indexing failed, video may need to be re-uploaded