Skip to main content
POST
Build a person from reference faces
Product: Video Datalake Host: https://api.memories.ai/datalake/v1 Auth: Authorization: sk-mai-...
Build a person in the face-reference library (202, async). Requires the collection’s face_recognition_enabled: true and a compliance tokenmetadata.consent_reference on the person or consent_document on the collection. If any image has no detectable face, the build fails (no_face).
Pricing: $0.00005 / reference image · See Pricing for the full model.
Persons hold biometric data. Always supply a real consent_reference — never fabricate one.

Response Fields

string
New person ID (per_ prefix).
string
Build Operation; poll to ready.

Authorizations

Authorization
string
header
required

Send Authorization: sk-mai-...

Body

application/json
collection_id
string
required
name
string
required

≤255

faces
string[]
required

1–20 http(s) image direct links (multipart alt: faces file parts, ≤15MB each).

metadata
object

Must carry consent_reference unless the collection has a consent_document.

Response

200 - application/json

Success