Reka AI Documentation

import requests
url = "https://vision-agent.api.reka.ai/v2/videos"
files = { "file": "open('<file1>', 'rb')" }
payload = {
    "video_url": ,
    "video_name": ,
    "group_id": ,
    "description": 
}
headers = {"X-Api-Key": "<apiKey>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.json())

{
  "video_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "uploading",
  "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"
  }
}

Upload a video file or URL without triggering indexing.

Authentication

X-Api-Keystring

API key authentication via X-Api-Key header

AuthorizationBearer

Bearer token authentication via Authorization header

Request

This endpoint expects a multipart form containing an optional file.

filefileOptional

video_urlstringOptional

URL to download video from

video_namestringOptional

Display name for the video. Required for file uploads.

group_idstringOptional

ID of the video group to associate this video with

descriptionstringOptional

Video description

Response

Successful Response

video_idstring

Unique identifier for the uploaded video

statusenum

Status of the upload

Allowed values:

metadataobject or null

Video metadata (populated after upload completes)