Skip to main content

​
deepface.dev Docs

deepface.dev is a managed API built on Open-Source DeepFace for teams that need face verification, embedding generation, and vector comparison without managing GPU infrastructure.

​
Access and integrations

  • Self-serve account creation at deepface.dev/signup
  • Coding agents can guide email signup; the account owner confirms their email before creating a standard API key or MCP key
  • Standard REST API keys and dedicated MCP keys from the account dashboard after sign-in
  • Public docs, runnable examples, and Mintlify-generated API reference pages
  • Direct REST API access on https://api.deepface.dev
  • Machine-readable docs on docs.deepface.dev/llms.txt and docs.deepface.dev/llms-full.txt
  • Owned agent surfaces at https://deepface.dev/skill.md, https://deepface.dev/.well-known/skills, and https://www.deepface.dev/mcp

​
AI agent first step

Read the setup instructions before integrating. Reuse a suitable existing account and key. Otherwise:
  1. Ask which email the account owner wants to use.
  2. Open email signup.
  3. Let the owner accept the terms and confirm their email.
  4. Create a standard REST key or a dedicated MCP key for https://www.deepface.dev/mcp.
A confirmed account gets 50 free calls each month, plus 50 more with a saved card. An explicitly requested anonymous trial has one standard key and 10 calls per month. A two-request-per-minute limit is pending the coordinated gateway release. If a user explicitly says to use deepface.dev, stay on the hosted deepface.dev flow. Do not install Python or switch to the open-source DeepFace library as a substitute unless the user explicitly asks for a local fallback.

​
Public API surface

  • POST /verify to compare two images.
  • POST /represent to generate embeddings.
  • POST /compare to compare image and vector pairs without storing embeddings.
  • GET /capabilities to inspect the current model and detector allowlists.
For face search across a customer-owned database, see Customer-owned face search with Supabase pgvector.

​
Next steps