Interface IFaceEmbeddingService

Provider-agnostic service for extracting face embeddings from images and comparing them for identity consistency.

interface IFaceEmbeddingService {
extractEmbedding(imageUrl): Promise<FaceEmbedding>;
compareFaces(a, b, threshold?): FaceComparisonResult;
}

Implemented by

ReplicateFaceEmbeddingService

Index

Methods

extractEmbedding compareFaces

Methods

extractEmbedding

extractEmbedding(imageUrl): Promise<FaceEmbedding>
Extract a face embedding vector from an image URL or data URI.
Parameters
- imageUrl: string
  Public URL or base64 data URI of the image.
Returns Promise<FaceEmbedding>
The extracted face embedding.
- Defined in src/media/images/face/IFaceEmbeddingService.ts:58

compareFaces

compareFaces(a, b, threshold?): FaceComparisonResult
Compare two face embeddings and return a similarity score.
Parameters
- a: number[]
  First face embedding vector.
- b: number[]
  Second face embedding vector.
- Optional threshold: number
  Minimum similarity to consider a match (default 0.6).
Returns FaceComparisonResult
Comparison result with similarity and match flag.
- Defined in src/media/images/face/IFaceEmbeddingService.ts:68