eKYC 본인확인
kyc_verifyVerify identity with an ID photo and a short selfie video or photo: ID screen-capture/editor detection, real-person liveness (turning the head left and right), and face match against the ID. Requires a single-use capture session from /rest/kyc_session. 신분증 사진과 좌우로 고개를 돌린 짧은 촬영 영상(또는 사진)으로 신분증 위조·화면 캡처, 실제 사람의 움직임, 신분증 얼굴과의 일치를 한 번에 판정합니다. 촬영 세션(/rest/kyc_session) 서명이 필요합니다. [호출당 200포인트]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session": "<session>",
"document_image_url": "<document_image_url>",
"face_video_url": "<face_video_url>",
"face_image_url": "<face_image_url>"
},
"name": "kyc_verify"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session | Yes | 촬영 세션 서명(/rest/kyc_session 발급 → /rest/kyc_seal 서명) | |
| threshold | No | 얼굴 일치 기준 점수 (범위: 0.2 ~ 0.8, 기본값 0.4) | |
| face_image_url | Yes | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) | |
| face_video_url | Yes | 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm, video/3gpp) (최대 30MB) | |
| document_image_url | Yes | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |