핀테크
신원 확인 파이프라인
KYC 및 온보딩 서비스는 검증 워크플로에서 API를 호출하여, 제출된 신분증의 사진이 공개 웹상의 동일 인물과 일치하는지 확인합니다.
FaceSearch REST API
어떤 언어에서든 얼굴 검색을 실행하세요
FaceSearch REST API는 개발자에게 작고 안정적인 역방향 얼굴 이미지 검색 인터페이스를 제공합니다. 사진을 제출하고, 완료될 때까지 상태를 조회하고, 결과를 읽으면 됩니다. Bearer 토큰 인증, 멱등 재시도, 공개 OpenAPI 스펙을 지원합니다.
수천 건의 검색
전 세계에서 이용 가능
256비트 암호화
높은 일치 정확도
FaceSearch REST API는 개발자에게 작고 안정적인 역방향 얼굴 이미지 검색 인터페이스를 제공합니다. 사진을 제출하고, 완료될 때까지 상태를 조회하고, 결과를 읽으면 됩니다. Bearer 토큰 인증, 멱등 재시도, 공개 OpenAPI 스펙을 지원합니다.
- 무엇으로 검색하나
- 얼굴이 담긴 사진 한 장. 텍스트 키워드 검색은 지원하지 않습니다.
- 무엇을 받게 되나
- 같은 얼굴이 등장하는 페이지를 순위대로 정리한 목록. 각 결과에 신뢰도 점수와 출처 링크가 붙습니다.
- 일치는 어떻게 판정되나
- 얼굴 인식입니다. 얼굴은 임베딩(숫자의 나열)으로 변환된 뒤 파일명이나 설명, 픽셀이 아니라 거리로 비교됩니다. 얼굴 인식은 어떻게 작동하나요?
- 검색 1회 비용
- 3 크레딧. 신규 계정은 무료 크레딧 3개로 시작하며 카드 등록이 필요 없습니다.
- 사진 보관 기간
- 검색이 끝난 뒤 24시간 이내에 업로드한 사진을 삭제합니다.
REST API 동작 원리
빈 터미널에서 첫 번째 검색 결과까지 단 세 단계.
API 키 생성
대시보드에 로그인해 키를 발급합니다. 평문은 단 한 번만 표시되므로 시크릿 매니저에 저장하고 소스 코드에는 절대 커밋하지 마세요.
이미지를 POST
Bearer 헤더와 함께 curl -F [email protected] https://facesearch.net/api/v1/search 를 실행합니다. 엔드포인트는 1초 이내에 jobId를 반환합니다.
완료될 때까지 폴링
3~5초마다 GET /api/v1/search/{jobId}를 호출합니다. 상태가 completed가 되면 일치한 출처 URL, 썸네일, 신뢰도 점수가 응답에 포함됩니다.
REST API 기능
프로덕션 백엔드에 얼굴 검색을 통합하는 데 필요한 모든 것.
OpenAPI 3.1 스펙
/api/v1/openapi.json에서 제공되는 수작업 OpenAPI 문서가 Postman 임포트부터 20개 이상의 언어로 생성되는 클라이언트까지 모든 타입 안전 SDK를 지원합니다.
멱등 재시도
RFC 9110의 Idempotency-Key 헤더를 보내면 서버는 중복 제출에 대해 동일한 jobId를 반환합니다. 헤더를 생략하더라도 서버가 콘텐츠 해시를 자동으로 생성하므로 단순 재시도도 항상 안전합니다.
키별 할당량
각 API 키에는 일일 및 월간 상한을 선택적으로 둘 수 있습니다. 유출된 키로 잔액 전체가 소진되는 일은 없으며, 할당량은 Redis 속도로 적용되고 Postgres 폴백이 있습니다.
세분화된 레이트 리밋
모든 응답에 X-RateLimit-Remaining과 X-RateLimit-Reset 헤더가 포함됩니다. 429 응답에는 Retry-After가 포함되어 언제 다시 시도할지 정확히 알 수 있습니다.
공유 크레딧 풀
API 사용량은 웹 UI와 동일한 크레딧 잔액에서 차감됩니다. 대시보드에서 한 번만 충전하면 두 면을 모두 사용할 수 있고, 새로운 과금 SKU를 관리할 필요가 없습니다.
예측 가능한 오류
모든 오류 응답은 code, message, status로 구성된 안정된 포맷입니다. INSUFFICIENT_CREDITS, RATE_LIMITED 같은 코드는 변하지 않으므로, 오류 처리 코드는 단순하게 오래 유지할 수 있습니다.
복사. 붙여넣기. 출시.
모든 FaceSearch API 호출은 하나의 HTTP 요청입니다. 동일한 '얼굴 검색 제출' 흐름을 다섯 가지 언어로 보여드립니다.
터미널 한 줄 명령
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
-H "Authorization: Bearer fs_live_YOUR_KEY" \
-H "Idempotency-Key: submit-$(date +%s)" \
-F "image=@/path/to/face.jpg" \
-F "consent=true"
# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
-H "Authorization: Bearer fs_live_YOUR_KEY"
# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
-H "Authorization: Bearer fs_live_YOUR_KEY"REST API 위에서 만들고 있는 사람들
이 API는 대규모 얼굴 검색이 필요한 팀을 지원합니다.
안전
자동화된 모더레이션
신뢰 및 안전 팀은 API를 사고 대응 파이프라인에 연결해, 에스컬레이션된 사용자 신고를 몇 시간이 아니라 몇 초 만에 맥락과 함께 보강합니다.
리서치
조사 연구
탐사 보도 기자와 OSINT 연구자는 Jupyter 노트북에서 대량 얼굴 검색을 스크립트로 실행하고, 멱등 키 헤더로 야간 배치 작업을 중복 제거합니다.
수천 명에게 신뢰받는
10MB
최대 업로드 크기
JPEG, PNG, WebP 이미지
24시간
이미지 보관 기간
업로드 이미지 자동 삭제
연중무휴
검색 가능 시간
언제든지 검색
3
검색당 크레딧
단순하고 투명한 가격
개발자들이 이 API에 대해 말하는 것
FaceSearch를 프로덕션 워크플로에 통합한 팀들의 실제 피드백.
“이 하이브리드 멱등 키 정책은 제가 본 어떤 API보다 훌륭합니다. 단순 재시도가 그냥 동작하고, 새 검색이 필요할 때는 명시적 키로 완전히 제어할 수 있습니다.”
“한나절 만에 FaceSearch를 저희 모더레이션 파이프라인에 연결했습니다. 키별 할당량 덕분에 팀마다 별도의 키를 나눠 줘도, 누군가 실수로 풀을 고갈시킬 걱정이 없습니다.”
“OpenAPI 스펙 덕분에 명령어 한 줄로 타입이 적용된 Python 클라이언트를 생성할 수 있었습니다. 오류 코드가 바뀌지 않으니, 제 파이프라인은 몇 달째 좋은 의미로 지루하게 돌아가고 있습니다.”
간단하고 투명한 가격
귀하의 요구에 맞는 플랜을 선택하세요. 숨겨진 수수료 없으며 언제든 취소 가능합니다.
가장 인기
PRO
$29/월
전문가 및 고급 사용자용
- 월 60 크레딧 (크레딧당 $0.48)
- 얼굴 검색
- 검색 기록
- 프로필을 PDF로 내보낼 수 있음
또는 크레딧 팩 구매
사용량 기반 결제
Starter
3크레딧
$6
$2.00/크레딧
20% 절약
Basic
30크레딧
$24
$0.80/크레딧
31% 절약
Standard
100크레딧
$69
$0.69/크레딧
34% 절약
Pro
300크레딧
$199
$0.66/크레딧
40% 절약
Enterprise
1000크레딧
$599
$0.60/크레딧
REST API FAQ
개발자가 첫 요청을 작성하기 전에 궁금해하는 모든 것.
