API documentation

Build with the VisionEra REST API.

Integrate face recognition, video analysis, and identity workflows into your application. Generate an API key and make your first request in minutes.

Enterprise-ready 99.99% uptime

Authentication

All API requests require an API key passed via the X-API-Key header. Generate API keys from your Dashboard → API Keys page.

curl -H "X-API-Key: ve_live_abc123..." https://visionera.live/api/...

API Endpoints

POST/api/faces/compare

1:1 Face Verification

Compare two face images to determine if they belong to the same person. Returns a similarity score and match decision.

Rate Limit60 requests/minute

Max File Size2 MB per image

FormatsJPEG, PNG, WebP, GIF

Parameters

source

filerequired

First face image

target

filerequired

Second face image

cURL Example

curl -X POST https://visionera.live/api/faces/compare   -H "X-API-Key: your_api_key_here" \
  -F "source=@photo1.jpg"   -F "target=@photo2.jpg"

Response

{
  "match": true,
  "similarity": 0.94,
  "confidence": "high",
  "faces_detected": {
    "image1": 1,
    "image2": 1
  }
}

Rate Limits

Rate limits are enforced per API key. When you exceed the limit, you'll receive a 429 Too Many Requests response. Rate limit headers are included in every response.

Endpoint	Rate Limit	Burst Limit
1:1 Face Compare	60 req/min	10 req/sec
1:N Face Search	30 req/min	5 req/sec
N:N Batch Match	10 req/min	2 req/sec
Video Analyze	10 req/min	2 req/sec
Video Status	120 req/min	20 req/sec

Rate Limit Headers

X-RateLimit-Limit: 60

X-RateLimit-Remaining: 45

X-RateLimit-Reset: 1625097600

Upload Constraints

🖼️ Images

• Formats: JPEG, PNG, WebP, GIF
• Max size: 2 MB per image (Free), 10 MB (Pro), 20 MB (Enterprise)
• Min resolution: 64x64 pixels
• Face must be clearly visible

🎬 Videos

• Formats: MP4, WebM, MOV, AVI
• Max size: 500 MB
• Max duration: 10 minutes recommended
• Processing is asynchronous (poll job status)

Error Codes

Code	Meaning	Resolution
400	Bad Request	Check request parameters and file formats
401	Unauthorized	Verify your API key is valid and active
403	Forbidden	Your plan may not support this endpoint
413	Payload Too Large	Reduce file size within plan limits
429	Too Many Requests	Wait and retry, or upgrade your plan
500	Internal Error	Contact support at info@visionera.live

Ready to integrate?

Generate your API key and start building with VisionEra in minutes.

Generate API key Contact sales