My API Keys

API Documentation

Authentication

Include your API key in the request header: 

X-API-Key: your_api_key_here

Endpoints

Method Endpoint Description
POST /api/v1/videos/upload Upload a video file (multipart/form-data)
GET /api/v1/videos List all your videos
GET /api/v1/videos/{id} Get video details
POST /api/v1/videos/{id}/process Start face detection processing
GET /api/v1/videos/{id}/detection Get detection results (JSON)
DELETE /api/v1/videos/{id} Delete a video

Example Response (Detection)

{
  "video_info": {
    "path": "video.mp4",
    "fps": 30,
    "duration_seconds": 60.5,
    "width": 1920,
    "height": 1080
  },
  "statistics": {
    "total_samples": 60,
    "total_faces_detected": 120,
    "max_faces_in_single_frame": 3
  },
  "frames": [
    {
      "timestamp": 0.0,
      "frame_number": 0,
      "faces_count": 1,
      "faces": [
        {
          "face_id": 0,
          "center": {"x": 500, "y": 300},
          "bbox": {
            "top_left": {"x": 400, "y": 200},
            "top_right": {"x": 600, "y": 200},
            "bottom_left": {"x": 400, "y": 400},
            "bottom_right": {"x": 600, "y": 400}
          },
          "width": 200,
          "height": 200,
          "confidence": 0.95
        }
      ]
    }
  ]
}