Developer & Platform Documentation

Complete integration and usage guide for the Sknn AI Platform. Learn how to authenticate, manage products, perform high-speed facial skin analysis, and utilize the Customer Portal.

1. Authentication

Authentication is performed via JSON Web Tokens (JWT) or API Keys depending on your subscription tier. All API requests must include the Authorization header or x-api-key.

Authorization: Bearer eyJhbGciOiJIUzI1Ni...
# OR
x-api-key: sk_test_123456789...

2. Core Endpoints

POST/api/v1/analyze

Uploads an image for full facial analysis. Returns a detailed report of acne, wrinkles, pores, and dark spots.

cURL Example

curl -X POST https://api.sknn.ai/v1/analyze \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: multipart/form-data" \ -F "file=@/path/to/face.jpg"

GET/POST/api/v1/products

Manage your product inventory. Products added here will be automatically recommended to end-users based on their skin analysis results.

JSON Payload (POST)

{ "name": "Vitamin C Serum", "category": "Serum", "price": 45.99, "inventory_count": 150, "target_concern": "dark_spots" }

3. Rate Limits

Tier	Req / Sec	Req / Month
Free Tier	1 req/s	500
Pro Tier	10 req/s	5,000
Enterprise	Unlimited	Unlimited

4. Customer Portal Guide

Account Identity & 2FA

Secure your account using our TOTP-based Two-Factor Authentication. Navigate to the Identity tab to enable 2FA using Google Authenticator or 1Password. You can also update your preferred billing currency (USD, INR, EUR, GBP, AUD) from this page.

Dashboard & Quotas

The Dashboard provides real-time metrics on your API usage, remaining scans for the month, total unique faces detected, and products suggested to your end-users.

Reports & Analytics

Access saved facial analysis reports directly from the Saved Reports section. View historical data, face attributes, and the exact skincare products that were recommended to your clients.