didit-face-match

Compare two facial images and return a similarity score from 0 to 100.

23|4|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/didit-protocol/didit-agent-skills --skill didit-face-match
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: didit-face-match
Source: https://github.com/didit-protocol/didit-agent-skills/tree/main/skills/didit-face-match
Command: npx skills add https://github.com/didit-protocol/didit-agent-skills --skill didit-face-match

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Compare two facial images to determine if they belong to the same person and return a similarity score between 0 and 100.

Core Features & Use Cases

  • Biometric matching: determine identity across two images with a single similarity score and optional age estimation or gender detection.
  • Robust to multiple faces: when images contain multiple faces, the largest face is used for comparison.
  • Configurable controls: adjustable decline threshold and optional image rotation to align upright faces.

Quick Start

Provide two image files and your API key to obtain a similarity score.

Frequently Asked Questions about didit-face-match

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare two faces in images to verify identity?

Face match comparison analyzes two facial images to determine if they belong to the same person. It returns a similarity score between 0 and 100, requiring an x-api-key header for authentication.

What image formats are supported for biometric face matching?

Biometric face matching supports JPEG, PNG, WebP, and TIFF image files. Each image can be up to 5MB in size, and the system automatically uses the largest face when multiple faces are detected.

Can I use face match API for selfie-to-document identity confirmation?

Selfie-to-document matching is a core use case for face match verification. You provide the two image files and your API key to obtain a similarity score for identity confirmation workflows.

How do I handle misaligned facial images during identity verification?

Identity verification supports optional image rotation to align upright faces before comparison. You can also configure a decline threshold to automatically reject matches below a specific similarity score.

Does face match support age estimation and gender detection alongside biometric matching?

Age estimation and gender detection are optional features available alongside biometric matching. The API determines identity across two images and can return these additional attributes with the similarity score.

What are the limitations of using a face match API for identity workflows?

Face match API requires a valid x-api-key header and has a 5MB file size limit per image. When multiple faces appear, it only processes the largest face, which may affect results if the wrong face is larger.