For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordGet API Key
  • Getting Started
    • Overview
    • Quickstart
    • Errors
    • Pricing
  • Chat
    • Overview
    • Chat with Image, Video, and Audio
    • Function Calling
    • Models
  • Vision
    • Overview
    • Rate Limits
    • Pricing
    • MCP Server
    • Video Management
    • Video Group Management
    • Video Search
    • Video QA
    • Clip Generation
    • Metadata Tagging
    • Image Management
    • Image Search
        • GETList Videos
        • POSTUpload Video
        • GETGet Video
        • DELDelete Video
        • PATCHUpdate Video Metadata
        • GETList Video Groups
        • POSTCreate Video Group
        • GETGet Video Group
        • DELDelete Video Group
        • PATCHUpdate Video Group
        • GETList Group Videos
        • POSTMove Videos To Group
        • GETGet Feature Catalog
        • POSTPlan Features
        • POSTTrigger Captions
        • POSTTrigger Objects
        • POSTTrigger Embeddings
        • POSTTrigger Transcript
        • POSTSearch
        • POSTChat
        • GETList Captions
        • GETList Transcript
        • GETList Scenes
        • GETList Objects
        • POSTSegment
  • Research
    • Overview
    • Streaming
    • Reasoning Steps
    • Web Search
    • Structured Output
    • Parallel Thinking
    • Best Practices
    • Errors
    • Examples
  • Speech
    • Overview
    • Audio Transcription
    • Speech Translation
    • Speech-to-Speech Translation
  • Resources
    • FAQs
    • Changelog
    • System Status
LogoLogo
DiscordGet API Key
VisionAPI ReferenceV2

Get Video

GET
https://vision-agent.api.reka.ai/v2/videos/:video_id
GET
/v2/videos/:video_id
$curl https://vision-agent.api.reka.ai/v2/videos/video_id \
>     -H "X-Api-Key: <apiKey>"
200Retrieved
1{
2  "video_id": "550e8400-e29b-41d4-a716-446655440000",
3  "url": "https://s3.amazonaws.com/bucket/video.mp4?presigned=...",
4  "status": "uploaded",
5  "metadata": {
6    "width": 1920,
7    "height": 1080,
8    "avg_fps": 23.976023976023978,
9    "video_name": "Kathy test",
10    "title": "Kathy test",
11    "video_start_timestamp_utc_ms": 1,
12    "duration": 641.939,
13    "thumbnail": "https://demo-videos-bucket-reka.s3.eu-west-2.amazonaws.com/None/images/{image_id}",
14    "description": "Uploaded video file: home/kathy/vids/tuscany.mp4",
15    "source": "home/kathy/vids/tuscany.mp4"
16  },
17  "features": {
18    "embeddings": "processing",
19    "transcript": "ready"
20  },
21  "group_id": "string",
22  "error": "string"
23}
Get video details including upload status and metadata.
Was this page helpful?
Previous

Delete Video

Next
Built with

Authentication

X-Api-Keystring

API key authentication via X-Api-Key header

OR
AuthorizationBearer
Bearer token authentication via Authorization header

Path parameters

video_idstringRequiredformat: "uuid"

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