Reka AI Documentation

import requests
url = "https://vision-agent.api.reka.ai/v2/videos/video_id"
headers = {"X-Api-Key": "<apiKey>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "video_id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://s3.amazonaws.com/bucket/video.mp4?presigned=...",
  "status": "uploaded",
  "metadata": {
    "width": 1920,
    "height": 1080,
    "avg_fps": 23.976023976023978,
    "video_name": "Kathy test",
    "title": "Kathy test",
    "video_start_timestamp_utc_ms": 1,
    "duration": 641.939,
    "thumbnail": "https://demo-videos-bucket-reka.s3.eu-west-2.amazonaws.com/None/images/{image_id}",
    "description": "Uploaded video file: home/kathy/vids/tuscany.mp4",
    "source": "home/kathy/vids/tuscany.mp4"
  },
  "features": {
    "embeddings": "processing",
    "transcript": "ready"
  },
  "group_id": "string",
  "error": "string"
}

Get video details including upload status and metadata.

Authentication

X-Api-Keystring

API key authentication via X-Api-Key header

AuthorizationBearer

Bearer token authentication via Authorization header

Path parameters

video_idstringRequired

Response

Successful Response

video_idstring

Unique identifier for the video

urlstring or null

Presigned S3 URL to access the video

statusenum or null

Upload status of the video

Allowed values:

metadataobject or null

Metadata for a video

featuresmap from strings to enums or null

Per-feature indexing statuses from the video_features table

group_idstring or null

Group ID if video belongs to a group

errorstring or null

Error message if upload/download failed