메인 콘텐츠로 건너뛰기
POST
cURL

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

multipart/form-data
user_image
file
필수

분석할 얼굴 사진(예: 셀피). 대상의 얼굴이 선명하게 보이고 조명이 밝은 정면 사진 한 장을 제출하십시오. 허용되는 확장자: tiff, jpg, jpeg, png, webp(PDF 불가). 최대 업로드 크기: 5 MB(더 큰 파일은 400과 함께 거부됨). 이미지는 처리 전에 약 0.3 MB로 자동 압축되므로 매우 높은 해상도가 정확도를 향상시키지는 않습니다.

face_liveness_score_decline_threshold
number<float>
기본값:30

라이브니스 임계값(0–100). 라이브니스 score가 이 값 이하인 경우 LOW_LIVENESS_SCORE 경고를 추가하고 거부합니다. 더 엄격한 안티 스푸핑을 위해 값을 올리십시오. 0–100 범위를 벗어난 값은 400을 반환합니다.

필수 범위: 0 <= x <= 100
예시:

30

age_estimation_decline_threshold
integer
기본값:18

허용 가능한 최소 추정 연령(세 단위)입니다. 추정 연령이 이 값 미만인 경우 AGE_BELOW_MINIMUM 경고가 추가되고 거부됩니다. 연령 확인을 비활성화하려면 0으로 설정하십시오(이 경우 연령 기반 결정 없이 라이브니스 + 연령 추정만 실행됩니다).

필수 범위: 0 <= x <= 100
예시:

18

rotate_image
boolean
기본값:false

true인 경우 서비스가 입력 이미지를 90도 단위(0, 90, 180, 270)로 시도하고 최적의 얼굴 감지 결과를 내는 방향을 사용합니다. EXIF 방향 정보가 누락된 모바일 촬영에 유용합니다. 지연 시간이 추가되므로 똑바른 이미지를 보장할 수 없는 경우에만 활성화하십시오.

예시:

false

save_api_request
boolean
기본값:true

true(기본값)인 경우 호출을 API 유형 세션으로 저장합니다. Business Console에서 확인할 수 있고 반환된 request_id를 사용하여 GET /v3/session/{sessionId}/decision/을 통해 조회할 수 있으며 status.updated webhook을 통해 알림이 전송되고 감지된 얼굴이 애플리케이션의 얼굴 색인에 추가됩니다. false인 경우 아무것도 저장되지 않으며 request_id는 응답 상관관계 식별 전용의 일시적인 UUID입니다.

예시:

true

vendor_data
string

저장된 세션에 저장되고 응답에 다시 반환되는 선택적 불투명 문자열(내부 사용자 ID, 이메일, UUID 등)입니다. API 호출을 자체 기록과 연관 짓고 나중에 세션을 필터링하는 데 사용합니다.

예시:

"user-123"

metadata
object

세션과 함께 저장되고(save_api_request=true인 경우) 응답에 그대로 반환되는 선택적 JSON 객체입니다. multipart 요청에서는 JSON 인코딩된 문자열 필드(예: metadata={"flow":"age-gate"})로 전송하십시오. 객체로 파싱됩니다.

예시:

응답

연령 추정 및 패시브 라이브니스가 완료되었습니다. age_estimation.age_estimation은 감지된 가장 큰 얼굴에 대해 모델이 예측한 연령(연 단위, 감지된 얼굴이 없으면 null)이며, age_estimation.score는 패시브 라이브니스 점수(0–100)입니다. status는 warnings가 비어 있는 경우에만 Approved입니다. 미성년자이거나 스푸핑된 캡처인 경우에도 status: "Declined"와 함께 200을 반환하므로, HTTP 코드뿐만 아니라 body도 확인하십시오. save_api_request=true인 경우 request_id는 저장된 세션 ID입니다.

request_id
string<uuid>

save_api_request=true일 때 유지된 세션 ID(GET /v3/session/{sessionId}/decision/와 함께 사용 가능), 그렇지 않으면 임시 상관관계 UUID입니다.

age_estimation
object
vendor_data
string | null

전송한 vendor_data의 에코 값 또는 null입니다.

metadata
object | null

전송한 metadata 객체의 에코 값 또는 null입니다.

created_at
string<date-time>

응답이 생성된 시점의 ISO 8601 타임스탬프(UTC)입니다.

마지막 수정일 2026년 11월 7일