namifusion

FaceDetect

namifusion/detect_faces

A face detection model used to detect facial information contained in input elements.

Examples

FaceDetect example 1

Parameters

NameTypeDefaultDescription
urlMedia URLtextImage or video URL. At least one of url or img is required. url has higher priority when both are provided.
imgBase64 ImagetextareaBase64-encoded image input (used when url is not provided).
num_framesNumber of Framesnumber5Number of frames to sample from video input.
return_face_urlReturn Face URLbooleantrueWhether to return cropped face image URLs.
single_faceSingle Face OnlybooleanfalseWhether to return only the largest detected face.
deduplicateDeduplicate FacesbooleantrueWhether to deduplicate faces across sampled video frames.
similarity_thresholdSimilarity Thresholdnumber0.45Deduplication similarity threshold (0.0-1.0); higher means stricter.
time_rangeTime Rangeobject[object Object]Optional video processing range in seconds; only effective for video input.

API

Call this model through one unified REST API. Get a key on the API Keys page.

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/namifusion/detect_faces \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "url": ..., "img": ..., "num_frames": ... } }'
FaceDetect API — Pricing, Playground & Docs | NamiFusion