{"info":{"_postman_id":"0d501ff6-6614-4917-a89d-7fe91e7516bd","name":"DeepFace API","description":"

Welcome to the DeepFace API, a secure and developer-friendly facial recognition platform designed for both real-world identity workflows and fun, consumer-facing applications.

DeepFace provides production-ready AI endpoints for:

Face verification
\n
Facial attribute analysis
\n
Look-alike and similarity matching
\n

StartFragment Each slot is corresponding to a dimension value and dimension value is emphasized with colors. Similar to 2D barcodes, vertical dimension stores no information in the illustration.EndFragment

\n\n

What DeepFace API Can Do

DeepFace allows developers to integrate advanced facial intelligence into their applications with minimal effort.

Core Capabilities

Face Verification
\n
Confirm whether two images belong to the same person (ID vs selfie).
\n
Face Analysis
\n
Extract facial attributes such as age, gender, race, and emotion.
\n
Look-Alike Matching
\n
Compare two faces and return similarity scores with UI-ready feedback.
\n

Each endpoint is optimized for accuracy and safe usage in production environments.

Designed for Real Applications

DeepFace API is suitable for a wide range of use cases:

Identity verification (KYC, onboarding)
\n
Fraud prevention
\n
Access control
\n
Analytics and personalization
\n
Social & entertainment apps
\n
Look-alike and celebrity match experiences
\n

Whether you’re building a serious identity system or a viral fun app, the API adapts to your needs.

How the API Works (High-Level)

Your application sends a request with image URLs or base64 images
\n
The API validates inputs and authentication
\n
Images are securely forwarded to internal AI engines
\n
Results are normalized and returned in a developer-friendly format
\n
Billing is applied only when conditions are met (success-based billing)
\n

Authentication Overview

All DeepFace API endpoints require API key authentication.

How Authentication Works

Each developer account has one or more API keys
\n
The API key must be sent with every request
\n
Authentication occurs before any processing or billing
\n

Required Header

X-API-KEY: YOUR_API_KEY\n\n

Requests without a valid API key are rejected immediately.

Billing Philosophy

DeepFace uses a fair and transparent billing model:

Face Verification → Charged only when verification succeeds
\n
Face Analysis → Charged only on successful analysis
\n
Look-Alike → Charged only when a verified match is detected
\n

This ensures developers are never billed for failed or invalid requests.

Billing details are always returned in the response.

Consistent Response Structure

All endpoints return responses using the same structure:

{\n  \"status\": \"success | failed | error\",\n  \"result\": \"endpoint-specific result\",\n  \"message\": \"Human-readable explanation\"\n}\n\n

This consistency makes it easy to:

Handle responses across multiple endpoints
\n
Build reusable client-side logic
\n
Display clear messages to users
\n

Error Handling & Safety

Common error categories include:

invalid_input
\n
invalid_image
\n
unauthorized
\n
insufficient_balance
\n
engine_unavailable
\n

Each endpoint documents its possible errors in detail.

Using Postman (Recommended)

DeepFace API is fully compatible with Postman and similar API testing tools.

Why Use Postman?

Test endpoints quickly
\n
Inspect responses easily
\n
Save collections for team use
\n
Auto-generate example requests
\n

Getting Started with Postman

Create a new request
\n
Set method to POST
\n
X-API-KEY: YOUR_API_KEY
\n
Content-Type: application/json
\n
Paste the endpoint URL
\n
Send a JSON body
\n
Click Send
\n

You’ll immediately see the response from the API.

Auto-Generated Requests & Examples

All examples in this documentation:

Are compatible with Postman
\n
Can be copied directly into Postman or cURL
\n
Use real request/response formats
\n

This makes onboarding fast and beginner-friendly.

Try-It Experience (Documentation UI)

The documentation interface supports:

Live request testing
\n
Copy-paste examples
\n
Endpoint-specific payload templates
\n
Real response previews
\n

Developers can test APIs without writing code.

Security & Privacy

DeepFace follows strict security principles:

Images are processed transiently
\n
No images are stored unless explicitly required
\n
API keys are never exposed
\n
Internal AI engines are fully isolated
\n

This makes DeepFace suitable for sensitive identity workflows.

Getting Your API Key

To start using the API:

Sign in to your dashboard
\n
Generate an API key
\n
Copy the key into your request headers
\n

👉 API Keys dashboard:

https://dashboard.deepface.sbs/apikeys\n\n

Next Steps

Once you understand the basics, explore the individual endpoint documentation:

Each page includes:

Detailed explanations
\n
Request/response examples
\n
Error tables
\n
Billing rules
\n

Developer Tip

Start with Postman first.

Once your request works in Postman, integration into your app is straightforward.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50946334","collectionId":"0d501ff6-6614-4917-a89d-7fe91e7516bd","publishedId":"2sB3dWqm49","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"7d5deb"},"publishDate":"2025-12-20T14:22:54.000Z"},"item":[{"name":"KYC Verification","id":"add48f78-1eeb-499a-afc7-2bf83f8991a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://images.ctfassets.net/xjcz23wx147q/iegram9XLv7h3GemB5vUR/0345811de2da23fafc79bd00b8e5f1c6/Max_Rehkopf_200x200.jpeg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/verify","description":"

Face Verification (ID ↔ Selfie)

Face Verification compares an identity document photo (ID) and a selfie to determine whether they belong to the same person.

This endpoint is designed specifically for real-world identity verification workflows, including:

ID vs selfie verification
\n
KYC / onboarding validation
\n
Fraud prevention
\n
Account access control
\n

⚠️ This endpoint does NOT support generic image-to-image comparison.

Exactly one ID image and one selfie image are required.

How It Works

The client submits two images:
\n
- img1 → Identity document image (ID)
  \n
- img2 → Selfie image
  \n
\n
Images are securely forwarded to an internal DeepFace verification engine.
\n
Before verification, the system validates:
\n
- A face exists in both images
  \n
- Exactly one ID and one selfie are provided
  \n
- The selfie contains only one clear face
  \n
\n
Facial features are extracted and compared using a trained DeepFace model.
\n
The engine evaluates:
\n
- Facial similarity distance
  \n
- Model threshold
  \n
- Verification decision
  \n
\n
A final decision is returned:
\n
- verified → ID matches the selfie
  \n
- not_verified → ID does not match the selfie
  \n
\n

💳 Billing is applied only when verification succeeds.

Authentication

API Key Authentication (Required)

All requests must include a valid API key in the request headers.

Required Header

X-API-KEY: YOUR_API_KEY\n\n

Authentication Rules

API key must belong to an active account
\n
Requests without an API key are rejected
\n
Suspended accounts are blocked
\n
Authentication occurs before image processing or billing
\n

API Base URL

https://api.deepface.sbs\n\n

Endpoint

POST /v1/verify\n\n

Full URL

POST https://api.deepface.sbs/v1/verify\n\n

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Required	Description
X-API-KEY	Yes	Your API authentication key
Content-Type	Yes	Must be `application/json`

Request Body

JSON

{\n  \"img1\": \"https://example.com/id.jpg\",\n  \"img2\": \"https://example.com/selfie.jpg\"\n}\n\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
img1	string	Yes	Identity document image (ID). Must contain a visible face
img2	string	Yes	Selfie image. Must contain exactly one clear face

Image Requirements

Images must be clear and well-lit
\n
Must be publicly accessible URLs or valid base64 images
\n
One ID + one selfie only
\n
Two selfies or two IDs are rejected
\n

Successful Response

ID Matches the Selfie

{\n  \"status\": \"success\",\n  \"result\": \"verified\",\n  \"message\": \"Face verification successful. ID matches the selfie.\",\n  \"engine_response\": {\n    \"verified\": true,\n    \"confidence\": 100,\n    \"decision\": \"passed\",\n    \"threshold\": 0.45,\n    \"status\": \"success\",\n    \"reason\": \"Face verification successful. ID matches the selfie.\",\n    \"details\": {\n      \"detector_backend\": \"opencv\",\n      \"distance\": 0,\n      \"model\": \"Facenet\",\n      \"processing_time\": 11.06,\n      \"facial_areas\": {\n        \"img1\": { \"x\": 380, \"y\": 1127, \"w\": 1380, \"h\": 1380 },\n        \"img2\": { \"x\": 380, \"y\": 1127, \"w\": 1380, \"h\": 1380 }\n      }\n    }\n  },\n  \"billing\": {\n    \"charged\": 0.25,\n    \"currency\": \"USD\"\n  }\n}\n\n

Failed Verification

ID Does Not Match the Selfie

{\n  \"status\": \"failed\",\n  \"result\": \"not_verified\",\n  \"message\": \"Face verification failed. ID does not match the selfie.\",\n  \"engine_response\": {\n    \"verified\": false,\n    \"confidence\": 0,\n    \"decision\": \"failed\",\n    \"threshold\": 0.45,\n    \"status\": \"success\",\n    \"reason\": \"Face verification failed. ID does not match the selfie.\",\n    \"details\": {\n      \"distance\": 1.061641,\n      \"model\": \"Facenet\",\n      \"processing_time\": 7.11\n    }\n  },\n  \"billing\": {\n    \"charged\": 0,\n    \"currency\": \"USD\"\n  }\n}\n\n

Validation Errors (Engine-Mapped)

These errors are returned before verification and match the engine logic exactly.

Two Selfies Uploaded

{\n  \"status\": \"failed\",\n  \"result\": \"id_required\",\n  \"message\": \"Please upload one ID image.\"\n}\n\n

Two IDs Uploaded

{\n  \"status\": \"failed\",\n  \"result\": \"selfie_required\",\n  \"message\": \"Please upload one selfie image.\"\n}\n\n

No Face Detected

{\n  \"status\": \"failed\",\n  \"result\": \"invalid_image\",\n  \"message\": \"No clear face detected in one of the images.\"\n}\n\n

Invalid Selfie (Multiple Faces)

{\n  \"status\": \"failed\",\n  \"result\": \"invalid_image\",\n  \"message\": \"Selfie image must contain exactly one clear face.\"\n}\n\n

HTTP Error Codes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description
400	Invalid input or image validation error
401	API key missing or invalid
403	Account suspended
402	Insufficient balance (on successful match only)
503	Verification service unavailable
504	Verification service timeout

Developer Notes

Always use engine_response.verified as the primary boolean result
\n
Lower distance values indicate higher facial similarity
\n
Billing occurs only when verification succeeds
\n
Internal engine URLs and raw errors are never exposed
\n
This endpoint is safe for production identity workflows
\n

Postman Test Body (Copy-Paste)

{\n  \"img1\": \"https://your-domain.com/sample-id.jpg\",\n  \"img2\": \"https://your-domain.com/sample-selfie.jpg\"\n\n

\n","urlObject":{"path":["v1","verify"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"1419c258-39ef-4f5d-b9ee-070f039a70d8","name":"Successful Verification","originalRequest":{"method":"POST","header":[{"key":"X-API-KEY","value":"YOUR_API_KEY","description":"Your API authentication key"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"img1\": \"https://deepface.sbs/img/person_a.jpg\",\n \"img2\": \"https://deepface.sbs/img/person_b.jpg\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.deepface.sbs/v1/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-API-KEY","value":"YOUR_API_KEY","description":"Your API authentication key","enabled":true},{"key":"Content-Type","value":"application/json","description":"","enabled":true}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"verified\",\n \"message\": \"Face verification successful. ID matches the selfie.\",\n \"engine_response\": {\n \"confidence\": 100,\n \"decision\": \"passed\",\n \"details\": {\n \"detector_backend\": \"opencv\",\n \"distance\": 0,\n \"facial_areas\": {\n \"img1\": {\n \"h\": 1380,\n \"w\": 1380,\n \"x\": 380,\n \"y\": 1127,\n \"left_eye\": [1313, 1647],\n \"right_eye\": [798, 1705]\n },\n \"img2\": {\n \"h\": 1380,\n \"w\": 1380,\n \"x\": 380,\n \"y\": 1127,\n \"left_eye\": [1313, 1647],\n \"right_eye\": [798, 1705]\n }\n },\n \"model\": \"Facenet\",\n \"processing_time\": 11.06\n },\n \"reason\": \"Face verification successful. ID matches the selfie.\",\n \"status\": \"success\",\n \"threshold\": 0.45,\n \"verified\": true\n },\n \"billing\": {\n \"charged\": 0.25,\n \"currency\": \"USD\"\n }\n}\n"},{"id":"6f0413d6-6e02-493a-b8a3-213b995fc2fc","name":"Insufficient Balance","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-KEY","value":"your_valid_api_key_here"}],"body":{"mode":"raw","raw":"{\"img1\": \"https://example.com/same_person_1.jpg\", \"img2\": \"https://example.com/same_person_2.jpg\"}","options":{"raw":{"language":"json"}}},"url":"https://api.deepface.sbs/v1/verify"},"status":"Payment Required","code":402,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","enabled":true},{"key":"X-API-KEY","value":"your_valid_api_key_here","description":"","enabled":true}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Payment Required\",\n \"message\": \"Insufficient balance to complete this verification. Please add credits to your account.\",\n \"status\": 402,\n \"current_balance\": 0.00,\n \"required_amount\": 0.01\n}"},{"id":"d9c4a29b-2a16-403b-bcfe-e09aacf53c5f","name":"Invalid API Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-KEY","value":"invalid_api_key"}],"body":{"mode":"raw","raw":"{\"img1\": \"https://example.com/person_a.jpg\", \"img2\": \"https://example.com/person_b.jpg\"}","options":{"raw":{"language":"json"}}},"url":"https://api.deepface.sbs/v1/verify"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","enabled":true},{"key":"X-API-KEY","value":"invalid_api_key","description":"","enabled":true}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Unauthorized\",\n \"message\": \"API key is missing or invalid. Please provide a valid API key in the X-API-KEY header.\",\n \"status\": 401\n}"},{"id":"c1ae029c-f7f4-45ed-9490-626650621f26","name":"Failed Verification","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-KEY","value":"your_valid_api_key_here"}],"body":{"mode":"raw","raw":"{\"img1\": \"https://example.com/person_a.jpg\", \"img2\": \"https://example.com/person_b.jpg\"}","options":{"raw":{"language":"json"}}},"url":"https://api.deepface.sbs/v1/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","enabled":true},{"key":"X-API-KEY","value":"your_valid_api_key_here","description":"","enabled":true}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": \"failed\",\n \"result\": \"not_verified\",\n \"message\": \"Face verification failed. ID does not match the selfie.\",\n \"engine_response\": {\n \"confidence\": 0,\n \"decision\": \"failed\",\n \"details\": {\n \"detector_backend\": \"opencv\",\n \"distance\": 1.061641,\n \"facial_areas\": {\n \"img1\": {\n \"h\": 1380,\n \"w\": 1380,\n \"x\": 380,\n \"y\": 1127,\n \"left_eye\": [1313, 1647],\n \"right_eye\": [798, 1705]\n },\n \"img2\": {\n \"h\": 619,\n \"w\": 619,\n \"x\": 525,\n \"y\": 215,\n \"left_eye\": null,\n \"right_eye\": null\n }\n },\n \"model\": \"Facenet\",\n \"processing_time\": 7.11\n },\n \"reason\": \"Face verification failed. ID does not match the selfie.\",\n \"status\": \"success\",\n \"threshold\": 0.45,\n \"verified\": false\n },\n \"billing\": {\n \"charged\": 0,\n \"currency\": \"USD\"\n }\n}\n"},{"id":"07e8b782-9c82-401a-ab52-418d8dad827d","name":"Account Suspended","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-API-KEY","value":"suspended_account_api_key"}],"body":{"mode":"raw","raw":"{\"img1\": \"https://example.com/person_a.jpg\", \"img2\": \"https://example.com/person_b.jpg\"}","options":{"raw":{"language":"json"}}},"url":"https://api.deepface.sbs/v1/verify"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","enabled":true},{"key":"X-API-KEY","value":"suspended_account_api_key","description":"","enabled":true}],"cookie":[],"responseTime":null,"body":"{\n \"error\": \"Forbidden\",\n \"message\": \"Your account has been suspended. Please contact support to resolve this issue.\",\n \"status\": 403\n}"}],"_postman_id":"add48f78-1eeb-499a-afc7-2bf83f8991a6"},{"name":"Face Analysis","id":"ded7235f-e2c6-4d3c-aa1b-304a74ffb378","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"image\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"actions\": [\"age\", \"gender\", \"race\", \"emotion\"]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/analyze?","description":"

Face Analysis

Face Analysis extracts facial attributes from a single image, including age, gender, race, and emotion.

This endpoint is designed for:

Demographic insights
\n
Emotion detection
\n
Content personalization
\n
Analytics and research use-cases
\n

How it Works

The client submits one image and specifies which facial attributes to analyze.

The system:

Validates the image URL
\n
Forwards the request to an internal DeepFace analysis engine
\n
Detects faces in the image
\n
Extracts the requested attributes
\n
Returns structured analysis results
\n

Billing is applied only when analysis succeeds.

Authentication

API Key Authentication (Required)

All requests must include a valid API key in the request headers.

Required Header

X-API-KEY: YOUR_API_KEY\n\n

Authentication Rules

API key must belong to an active account
\n
Missing or invalid keys are rejected
\n
Suspended accounts are blocked
\n
Authentication occurs before processing or billing
\n

Authentication Errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

HTTP Code	Description
401	API key missing or invalid
403	Account suspended
402	Insufficient balance

Billing Policy

Billing occurs only on successful analysis
\n
Failed requests are not charged
\n
Charged amount is returned in the response
\n

API Base URL

https://api.deepface.sbs\n\n

Endpoint

POST /v1/analyze\n\n

Full Request URL

POST https://api.deepface.sbs/v1/analyze\n\n

HTTP Method

POST\n\n

JSON request bodies only.

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Required	Description
X-API-KEY	Yes	Your API authentication key
Content-Type	Yes	Must be `application/json`

Example Request (cURL)

curl -X POST https://api.deepface.sbs/v1/analyze \\\n  -H \"X-API-KEY: YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"image\": \"https://deepface.sbs/img/person.jpg\",\n    \"actions\": [\"age\", \"gender\", \"race\", \"emotion\"]\n  }'\n\n

Request Body

{\n  \"image\": \"https://deepface.sbs/img/person.jpg\",\n  \"actions\": [\"age\", \"gender\", \"race\", \"emotion\"]\n}\n\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
image	string	Yes	Image URL or base64 string
actions	array	Yes	Facial attributes to analyze

Supported Actions

age
\n
gender
\n
race
\n
emotion
\n

Response Example (Success)

{\n    \"status\": \"success\",\n    \"result\": \"analysis_complete\",\n    \"message\": \"Facial analysis completed successfully\",\n    \"faces_detected\": 1,\n    \"results\": [\n        {\n            \"age\": [\n                {\n                    \"age\": 25,\n                    \"face_confidence\": 0.94,\n                    \"region\": {\n                        \"h\": 329,\n                        \"left_eye\": [\n                            325,\n                            402\n                        ],\n                        \"right_eye\": [\n                            191,\n                            417\n                        ],\n                        \"w\": 329,\n                        \"x\": 102,\n                        \"y\": 279\n                    }\n                }\n            ]\n        },\n        {\n            \"gender\": [\n                {\n                    \"dominant_gender\": \"Man\",\n                    \"face_confidence\": 0.94,\n                    \"gender\": {\n                        \"Man\": 99.51113891601562,\n                        \"Woman\": 0.48885825276374817\n                    },\n                    \"region\": {\n                        \"h\": 329,\n                        \"left_eye\": [\n                            325,\n                            402\n                        ],\n                        \"right_eye\": [\n                            191,\n                            417\n                        ],\n                        \"w\": 329,\n                        \"x\": 102,\n                        \"y\": 279\n                    }\n                }\n            ]\n        },\n        {\n            \"race\": [\n                {\n                    \"dominant_race\": \"black\",\n                    \"face_confidence\": 0.94,\n                    \"race\": {\n                        \"asian\": 2.379372254779355e-9,\n                        \"black\": 100,\n                        \"indian\": 7.843057119316654e-7,\n                        \"latino hispanic\": 2.931611176038018e-9,\n                        \"middle eastern\": 5.9640762956807234e-15,\n                        \"white\": 2.8509079184847394e-14\n                    },\n                    \"region\": {\n                        \"h\": 329,\n                        \"left_eye\": [\n                            325,\n                            402\n                        ],\n                        \"right_eye\": [\n                            191,\n                            417\n                        ],\n                        \"w\": 329,\n                        \"x\": 102,\n                        \"y\": 279\n                    }\n                }\n            ]\n        },\n        {\n            \"emotion\": [\n                {\n                    \"dominant_emotion\": \"neutral\",\n                    \"emotion\": {\n                        \"angry\": 5.36071252822876,\n                        \"disgust\": 0.3282541334629059,\n                        \"fear\": 7.490002632141113,\n                        \"happy\": 0.7017542719841003,\n                        \"neutral\": 78.49908447265625,\n                        \"sad\": 6.802980422973633,\n                        \"surprise\": 0.817212700843811\n                    },\n                    \"face_confidence\": 0.94,\n                    \"region\": {\n                        \"h\": 329,\n                        \"left_eye\": [\n                            325,\n                            402\n                        ],\n                        \"right_eye\": [\n                            191,\n                            417\n                        ],\n                        \"w\": 329,\n                        \"x\": 102,\n                        \"y\": 279\n                    }\n                }\n            ]\n        }\n    ],\n    \"billing\": {\n        \"charged\": 0.3,\n        \"currency\": \"USD\"\n    }\n}\n\n

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

HTTP Code	Description
400	Invalid request or image
401	Unauthorized
403	Account suspended
402	Insufficient balance
503	Analysis service unavailable
504	Analysis service timeout

Notes

Multiple faces may be detected
\n
Each face is analyzed independently
\n
Results are returned per requested action
\n
Engine internals are never exposed
\n

\n","urlObject":{"path":["v1","analyze"],"host":[""],"query":[{"key":"","value":null}],"variable":[]}},"response":[{"id":"97d0069e-c845-4221-a578-5ced708442b0","name":"Face Analysis","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"image\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"actions\": [\"age\", \"gender\", \"race\", \"emotion\"]\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":{"raw":"/v1/analyze?","host":[""],"path":["v1","analyze"],"query":[{"key":"","value":null}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.19"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"733"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Sat, 20 Dec 2025 02:42:10 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"analysis_complete\",\n \"message\": \"Facial analysis completed successfully\",\n \"faces_detected\": 1,\n \"results\": [\n {\n \"age\": [\n {\n \"age\": 25,\n \"face_confidence\": 0.94,\n \"region\": {\n \"h\": 329,\n \"left_eye\": [\n 325,\n 402\n ],\n \"right_eye\": [\n 191,\n 417\n ],\n \"w\": 329,\n \"x\": 102,\n \"y\": 279\n }\n }\n ]\n },\n {\n \"gender\": [\n {\n \"dominant_gender\": \"Man\",\n \"face_confidence\": 0.94,\n \"gender\": {\n \"Man\": 99.51113891601562,\n \"Woman\": 0.48885825276374817\n },\n \"region\": {\n \"h\": 329,\n \"left_eye\": [\n 325,\n 402\n ],\n \"right_eye\": [\n 191,\n 417\n ],\n \"w\": 329,\n \"x\": 102,\n \"y\": 279\n }\n }\n ]\n },\n {\n \"race\": [\n {\n \"dominant_race\": \"black\",\n \"face_confidence\": 0.94,\n \"race\": {\n \"asian\": 2.379372254779355e-9,\n \"black\": 100,\n \"indian\": 7.843057119316654e-7,\n \"latino hispanic\": 2.931611176038018e-9,\n \"middle eastern\": 5.9640762956807234e-15,\n \"white\": 2.8509079184847394e-14\n },\n \"region\": {\n \"h\": 329,\n \"left_eye\": [\n 325,\n 402\n ],\n \"right_eye\": [\n 191,\n 417\n ],\n \"w\": 329,\n \"x\": 102,\n \"y\": 279\n }\n }\n ]\n },\n {\n \"emotion\": [\n {\n \"dominant_emotion\": \"neutral\",\n \"emotion\": {\n \"angry\": 5.36071252822876,\n \"disgust\": 0.3282541334629059,\n \"fear\": 7.490002632141113,\n \"happy\": 0.7017542719841003,\n \"neutral\": 78.49908447265625,\n \"sad\": 6.802980422973633,\n \"surprise\": 0.817212700843811\n },\n \"face_confidence\": 0.94,\n \"region\": {\n \"h\": 329,\n \"left_eye\": [\n 325,\n 402\n ],\n \"right_eye\": [\n 191,\n 417\n ],\n \"w\": 329,\n \"x\": 102,\n \"y\": 279\n }\n }\n ]\n }\n ],\n \"billing\": {\n \"charged\": 0.3,\n \"currency\": \"USD\"\n }\n}"}],"_postman_id":"ded7235f-e2c6-4d3c-aa1b-304a74ffb378"},{"name":"Look-Alike","id":"00640a01-7b42-4082-a728-c2b6ea786457","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://images.ctfassets.net/xjcz23wx147q/iegram9XLv7h3GemB5vUR/0345811de2da23fafc79bd00b8e5f1c6/Max_Rehkopf_200x200.jpeg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike","description":"

Look-Alike / Celebrity Match

The Look-Alike API compares two faces and determines how similar they are.

This endpoint is built for:

Look-alike apps
\n
Celebrity matching
\n
Family resemblance detection
\n
Fun & social features
\n

⚠️ Low similarity is NOT an error — it is a valid result.

How it Works

The client submits two images:

img1 → Primary face
\n
img2 → Comparison face
\n

The system:

Validates both images
\n
Extracts facial features
\n
Compares similarity vectors
\n
Calculates similarity score
\n
Returns UI-ready feedback
\n

Billing is applied only when a verified match occurs.

Authentication

Same API key authentication rules as other endpoints.

Billing Policy

Billing occurs only when verified = true
\n
Low or no resemblance is not charged
\n
Billing info is returned in the response
\n

Endpoint

POST /v1/lookalike\n\n

Full Request URL

POST https://api.deepface.sbs/v1/lookalike\n\n

Example Request (cURL)

curl -X POST https://api.deepface.sbs/v1/lookalike \\\n  -H \"X-API-KEY: YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"img1\": \"https://deepface.sbs/img/person_a.jpg\",\n    \"img2\": \"https://deepface.sbs/img/person_b.jpg\"\n  }'\n\n

Request Body

{\n  \"img1\": \"https://deepface.sbs/img/person_a.jpg\",\n  \"img2\": \"https://deepface.sbs/img/person_b.jpg\"\n}\n\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
img1	string	Yes	First face image
img2	string	Yes	Second face image

Response Example (Strong Resemblance)

{\n    \"status\": \"success\",\n    \"result\": \"comparison_complete\",\n    \"message\": \"Face comparison completed\",\n    \"similarity\": 100,\n    \"similarity_label\": \"very_high\",\n    \"verified\": true,\n    \"ui_hint\": {\n        \"emoji\": \"👨‍👩‍👧\",\n        \"message\": \"Strong resemblance\"\n    },\n    \"billing\": {\n        \"charged\": 0.2,\n        \"currency\": \"USD\"\n    }\n}\n\n

Response Example (Low Resemblance)

{\n    \"status\": \"success\",\n    \"result\": \"comparison_complete\",\n    \"message\": \"Face comparison completed\",\n    \"similarity\": 0,\n    \"similarity_label\": \"low\",\n    \"verified\": false,\n    \"ui_hint\": {\n        \"emoji\": \"😅\",\n        \"message\": \"Low resemblance\"\n    },\n    \"billing\": {\n        \"charged\": 0,\n        \"currency\": \"USD\"\n    }\n}\n\n

Response Fields

Top-Level Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
status	string	Request status
result	string	comparison_complete
similarity	number	Similarity score (0–100)
similarity_label	string	low / medium / high / very_high
verified	boolean	Whether faces strongly match
ui_hint	object	Emoji & UI feedback
billing	object	Billing details

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

HTTP Code	Description
400	Invalid image or request
401	Unauthorized
403	Account suspended
402	Insufficient balance
503	Look-alike service unavailable
504	Look-alike service timeout

Developer Tips

Treat all look-alike responses as valid results
\n
Use similarity_label for UI messaging
\n
Use verified for billing or unlock logic
\n
Ideal for viral, fun applications
\n

\n","urlObject":{"path":["v1","lookalike"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"0ff20020-da53-4e42-b99d-d07ccb0447ce","name":"Look-Alike / Celebrity Match","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.19"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"258"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Sat, 20 Dec 2025 02:45:14 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"comparison_complete\",\n \"message\": \"Face comparison completed\",\n \"similarity\": 100,\n \"similarity_label\": \"very_high\",\n \"verified\": true,\n \"ui_hint\": {\n \"emoji\": \"👨\\u200d👩\\u200d👧\",\n \"message\": \"Strong resemblance\"\n },\n \"billing\": {\n \"charged\": 0.2,\n \"currency\": \"USD\"\n }\n}"},{"id":"c9446fd9-3d50-457f-bfeb-e1f8bf657529","name":"Look-Alike / Celebrity Match","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://images.ctfassets.net/xjcz23wx147q/iegram9XLv7h3GemB5vUR/0345811de2da23fafc79bd00b8e5f1c6/Max_Rehkopf_200x200.jpeg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.19"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"233"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Sat, 20 Dec 2025 02:46:36 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"comparison_complete\",\n \"message\": \"Face comparison completed\",\n \"similarity\": 0,\n \"similarity_label\": \"low\",\n \"verified\": false,\n \"ui_hint\": {\n \"emoji\": \"😅\",\n \"message\": \"Low resemblance\"\n },\n \"billing\": {\n \"charged\": 0,\n \"currency\": \"USD\"\n }\n}"}],"_postman_id":"00640a01-7b42-4082-a728-c2b6ea786457"},{"name":"Celebrity Look-Alike","id":"045fbca4-9a17-4fd7-8790-6a657980a3f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://images.ctfassets.net/xjcz23wx147q/iegram9XLv7h3GemB5vUR/0345811de2da23fafc79bd00b8e5f1c6/Max_Rehkopf_200x200.jpeg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike","description":"

Look-Alike / Celebrity Match

The Look-Alike API compares two faces and determines how similar they are.

This endpoint is built for:

Look-alike apps
\n
Celebrity matching
\n
Family resemblance detection
\n
Fun & social features
\n

⚠️ Low similarity is NOT an error — it is a valid result.

How it Works

The client submits two images:

img1 → Primary face
\n
img2 → Comparison face
\n

The system:

Validates both images
\n
Extracts facial features
\n
Compares similarity vectors
\n
Calculates similarity score
\n
Returns UI-ready feedback
\n

Billing is applied only when a verified match occurs.

Authentication

Same API key authentication rules as other endpoints.

Billing Policy

Billing occurs only when verified = true
\n
Low or no resemblance is not charged
\n
Billing info is returned in the response
\n

Endpoint

POST /v1/lookalike\n\n

Full Request URL

POST https://api.deepface.sbs/v1/lookalike\n\n

Example Request (cURL)

curl -X POST https://api.deepface.sbs/v1/lookalike \\\n  -H \"X-API-KEY: YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"img1\": \"https://deepface.sbs/img/person_a.jpg\",\n    \"img2\": \"https://deepface.sbs/img/person_b.jpg\"\n  }'\n\n

Request Body

{\n  \"img1\": \"https://deepface.sbs/img/person_a.jpg\",\n  \"img2\": \"https://deepface.sbs/img/person_b.jpg\"\n}\n\n

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Required	Description
img1	string	Yes	First face image
img2	string	Yes	Second face image

Response Example (Strong Resemblance)

{\n    \"status\": \"success\",\n    \"result\": \"comparison_complete\",\n    \"message\": \"Face comparison completed\",\n    \"similarity\": 100,\n    \"similarity_label\": \"very_high\",\n    \"verified\": true,\n    \"ui_hint\": {\n        \"emoji\": \"👨‍👩‍👧\",\n        \"message\": \"Strong resemblance\"\n    },\n    \"billing\": {\n        \"charged\": 0.2,\n        \"currency\": \"USD\"\n    }\n}\n\n

Response Example (Low Resemblance)

{\n    \"status\": \"success\",\n    \"result\": \"comparison_complete\",\n    \"message\": \"Face comparison completed\",\n    \"similarity\": 0,\n    \"similarity_label\": \"low\",\n    \"verified\": false,\n    \"ui_hint\": {\n        \"emoji\": \"😅\",\n        \"message\": \"Low resemblance\"\n    },\n    \"billing\": {\n        \"charged\": 0,\n        \"currency\": \"USD\"\n    }\n}\n\n

Response Fields

Top-Level Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
status	string	Request status
result	string	comparison_complete
similarity	number	Similarity score (0–100)
similarity_label	string	low / medium / high / very_high
verified	boolean	Whether faces strongly match
ui_hint	object	Emoji & UI feedback
billing	object	Billing details

Error Responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

HTTP Code	Description
400	Invalid image or request
401	Unauthorized
403	Account suspended
402	Insufficient balance
503	Look-alike service unavailable
504	Look-alike service timeout

Developer Tips

Treat all look-alike responses as valid results
\n
Use similarity_label for UI messaging
\n
Use verified for billing or unlock logic
\n
Ideal for viral, fun applications
\n

\n","urlObject":{"path":["v1","lookalike"],"host":[""],"query":[],"variable":[]}},"response":[{"id":"b43a536e-3dcc-4469-a962-556bd3f1d195","name":"Look-Alike / Celebrity Match","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.19"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"258"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Sat, 20 Dec 2025 02:45:14 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"comparison_complete\",\n \"message\": \"Face comparison completed\",\n \"similarity\": 100,\n \"similarity_label\": \"very_high\",\n \"verified\": true,\n \"ui_hint\": {\n \"emoji\": \"👨\\u200d👩\\u200d👧\",\n \"message\": \"Strong resemblance\"\n },\n \"billing\": {\n \"charged\": 0.2,\n \"currency\": \"USD\"\n }\n}"},{"id":"812a8160-0ffe-4c39-a55d-1a279660c397","name":"Look-Alike / Celebrity Match","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"df_live_ecK82O6TiCVJwAgtwnDMnAgZRBcw3h_T-E41Mvr4m2c","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"img1\": \"https://pis.center/api/uploads/68a4ad9f79e2e.jpg\",\r\n \"img2\": \"https://images.ctfassets.net/xjcz23wx147q/iegram9XLv7h3GemB5vUR/0345811de2da23fafc79bd00b8e5f1c6/Max_Rehkopf_200x200.jpeg\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"/v1/lookalike"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"Keep-Alive"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"X-Powered-By","value":"PHP/8.3.19"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"233"},{"key":"Content-Encoding","value":"br"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Date","value":"Sat, 20 Dec 2025 02:46:36 GMT"},{"key":"Server","value":"LiteSpeed"},{"key":"platform","value":"hostinger"},{"key":"panel","value":"hpanel"},{"key":"Content-Security-Policy","value":"upgrade-insecure-requests"},{"key":"alt-svc","value":"h3=\":443\"; ma=2592000, h3-29=\":443\"; ma=2592000, h3-Q050=\":443\"; ma=2592000, h3-Q046=\":443\"; ma=2592000, h3-Q043=\":443\"; ma=2592000, quic=\":443\"; ma=2592000; v=\"43,46\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": \"comparison_complete\",\n \"message\": \"Face comparison completed\",\n \"similarity\": 0,\n \"similarity_label\": \"low\",\n \"verified\": false,\n \"ui_hint\": {\n \"emoji\": \"😅\",\n \"message\": \"Low resemblance\"\n },\n \"billing\": {\n \"charged\": 0,\n \"currency\": \"USD\"\n }\n}"}],"_postman_id":"045fbca4-9a17-4fd7-8790-6a657980a3f0"}],"variable":[{"key":"baseURL","value":"","type":"default"}]}