Authentication

All Face SDK API requests require authentication via an API key.

API Key

Include your API key in the x-key-secret request header:

Header
x-key-secret: your-api-key-here

Getting Your API Key

  1. Create an account at the registration page
  2. Verify your email address
  3. Navigate to Dashboard → API Key
  4. Your API key is automatically generated on registration

Error Responses

401 Unauthorized
{"detail": "Invalid or inactive API key"}
429 Too Many Requests
{"detail": {"error": "quota_exceeded", "message": "Monthly API quota reached", "used": 100, "limit": 100}}
403 Forbidden
{"detail": "Account suspended"}