Verify whether two images match
Authorizations
Use your API key as a bearer token.
Headers
Optional UUID used for request tracing. Use a new UUID for each logical request and preserve the echoed value when contacting support. The gateway forwards the normalized or generated UUID on every internal admission retry. Reusing a postpaid UUID returns 409 request_id_conflict rather than replaying a cached result; do not change IDs to bypass an uncertain outcome.
Body
Base64 image payload, data URL, or (when an authenticated model-server integration explicitly enables it) a signed HTTPS Supabase Storage object URL from the configured exact-origin allowlist. The managed API requires a direct, non-redirecting JPEG, PNG, or WebP response from that URL. It rejects images that exceed the active byte, request-size, or decoded pixel safety limits before forwarding work to the model runtime; arbitrary remote URL fetching is never enabled globally.
Base64 image payload, data URL, or (when an authenticated model-server integration explicitly enables it) a signed HTTPS Supabase Storage object URL from the configured exact-origin allowlist. The managed API requires a direct, non-redirecting JPEG, PNG, or WebP response from that URL. It rejects images that exceed the active byte, request-size, or decoded pixel safety limits before forwarding work to the model runtime; arbitrary remote URL fetching is never enabled globally.
Approved model name from the current allowlist. For /verify and /represent, omitted, blank, or overlong values are treated as absent and the gateway injects the active default model.
200"Facenet"
Optional detector backend from the current allowlist. When the active detector misses a face, the service may retry configured fallback detectors before returning no_face_detected.
"opencv"
Optional DeepFace normalization mode.
cosine, euclidean, euclidean_l2 "cosine"