핀테크
신원 확인 파이프라인
KYC 및 온보딩 서비스는 검증 워크플로에서 API를 호출하여, 제출된 신분증의 사진이 공개 웹상의 동일 인물과 일치하는지 확인합니다.
FaceSearch REST API
어떤 언어에서든 얼굴 검색을 실행하세요
FaceSearch REST API는 개발자에게 작고 안정적인 역방향 얼굴 이미지 검색 인터페이스를 제공합니다. 사진을 제출하고, 완료될 때까지 상태를 조회하고, 결과를 읽으면 됩니다. Bearer 토큰 인증, 멱등 재시도, 공개 OpenAPI 스펙을 지원합니다.
엔드포인트 1개 • 검색당 3 크레딧 • 전 과정 JSON
전 세계 수천 명이 신뢰합니다
15,000+ 검색
50+ 국가
256비트 암호화
99.7% 정확도
REST API 동작 원리
빈 터미널에서 첫 번째 검색 결과까지 단 세 단계.
1
API 키 생성
대시보드에 로그인해 키를 발급합니다. 평문은 단 한 번만 표시되므로 시크릿 매니저에 저장하고 소스 코드에는 절대 커밋하지 마세요.
2
이미지를 POST
Bearer 헤더와 함께 curl -F [email protected] https://facesearch.net/api/v1/search 를 실행합니다. 엔드포인트는 1초 이내에 jobId를 반환합니다.
3
완료될 때까지 폴링
3~5초마다 GET /api/v1/search/{jobId}를 호출합니다. 상태가 completed가 되면 일치한 출처 URL, 썸네일, 신뢰도 점수가 응답에 포함됩니다.
REST API 기능
프로덕션 백엔드에 얼굴 검색을 통합하는 데 필요한 모든 것.
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 노트북에서 대량 얼굴 검색을 스크립트로 실행하고, 멱등 키 헤더로 야간 배치 작업을 중복 제거합니다.
수천 명에게 신뢰받는
천만+
완료된 검색
전 세계적으로 신뢰할 수 있는 결과
95%
매칭 정확도
고급 AI 기반
5만+
활성 사용자
성장하는 커뮤니티
1억+
스캔된 소스
포괄적 커버리지
개발자들이 이 API에 대해 말하는 것
FaceSearch를 프로덕션 워크플로에 통합한 팀들의 실제 피드백.
"이 하이브리드 멱등 키 정책은 제가 본 어떤 API보다 훌륭합니다. 단순 재시도가 그냥 동작하고, 새 검색이 필요할 때는 명시적 키로 완전히 제어할 수 있습니다."
"한나절 만에 FaceSearch를 저희 모더레이션 파이프라인에 연결했습니다. 키별 할당량 덕분에 팀마다 별도의 키를 나눠 줘도, 누군가 실수로 풀을 고갈시킬 걱정이 없습니다."
"OpenAPI 스펙 덕분에 명령어 한 줄로 타입이 적용된 Python 클라이언트를 생성할 수 있었습니다. 오류 코드가 바뀌지 않으니, 제 파이프라인은 몇 달째 좋은 의미로 지루하게 돌아가고 있습니다."
간단하고 투명한 가격
귀하의 요구에 맞는 플랜을 선택하세요. 숨겨진 수수료 없으며 언제든 취소 가능합니다.
가장 인기
PRO
$29/월
전문가 및 고급 사용자용
- 100 Credits per month ($0.29 per credit)
- Face Search
- Search History
- Can Export Profile to PDF
사용량 기반 결제
또는 크레딧 팩 구매
Starter
3크레딧
$6
$2.00/credit
절약 20%
Basic
30크레딧
$24
$0.80/credit
절약 31%
Standard
100크레딧
$69
$0.69/credit
절약 34%
Pro
300크레딧
$199
$0.66/credit
절약 40%
Enterprise
1000크레딧
$599
$0.60/credit
REST API FAQ
개발자가 첫 요청을 작성하기 전에 궁금해하는 모든 것.
REST API로 개발 시작하기
무료 API 키를 만들고 curl 한 줄을 붙여 넣으면 10분 안에 첫 검색을 실행할 수 있습니다.
API 키 생성
No credit card required
