> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Face Liveness 모범 사례

> 최적의 Face Liveness 감지 및 정확도를 위한 가이드라인

<Callout type="info">
  최적의 성능과 정확도를 보장하기 위해 신원 확인 처리를 위해 다음 이미지 파일 가이드라인을 따라야 합니다.
</Callout>

## 이미지 품질 요구사항

<CardGroup cols={2}>
  <Card title="해상도" icon="image">
    더 나은 감지 정확도를 위해 고해상도 이미지(최소 640x480 픽셀)를 사용하세요.
  </Card>

  <Card title="형식" icon="file">
    지원 형식: JPEG, PNG, WebP. 품질 손실 없이 적절한 압축을 보장하세요.
  </Card>

  <Card title="조명" icon="sun">
    거친 그림자나 과도한 노출 없이 충분하고 균등한 조명을 보장하세요.
  </Card>

  <Card title="초점" icon="camera">
    이미지는 선명하고 초점이 맞아야 하며, 흐리거나 픽셀화된 콘텐츠를 피하세요.
  </Card>
</CardGroup>

## 콘텐츠 가이드라인

<Steps>
  <Step title="자연스러운 표정">
    강제된 미소나 과장된 포즈 없이 자연스러운 표정을 캡처하세요.
  </Step>

  <Step title="직시">
    최적의 감지를 위해 눈이 열려 있고 카메라를 직접 바라보고 있어야 합니다.
  </Step>

  <Step title="전체 얼굴">
    가능한 경우 귀와 헤어라인을 포함하여 전체 얼굴이 보이도록 하세요.
  </Step>

  <Step title="방해 요소 없음">
    얼굴 특징을 가릴 수 있는 안경, 마스크, 모자 또는 기타 아이템을 피하세요.
  </Step>
</Steps>

## 피해야 할 일반적인 문제

<CardGroup cols={1}>
  <Card title="나쁜 조명" icon="moon" color="red">
    감지에 간섭할 수 있는 낮은 조명 조건, 거친 그림자 또는 과도하게 노출된 이미지를 피하세요.
  </Card>

  <Card title="흐린 이미지" icon="eye-off" color="red">
    이미지가 선명하고 초점이 맞도록 하세요. 흐린 이미지는 감지 실패를 초래할 수 있습니다.
  </Card>

  <Card title="부분 얼굴" icon="user-x" color="red">
    얼굴의 일부를 자르거나 부분적인 얼굴 특징만 보이는 것을 피하세요.
  </Card>

  <Card title="여러 얼굴" icon="users" color="red">
    이미지에는 얼굴이 하나만 포함되어야 합니다. 여러 얼굴은 감지 문제를 일으킬 수 있습니다.
  </Card>

  <Card title="반사" icon="sun" color="red">
    얼굴 분석에 간섭할 수 있는 안경이나 기타 표면의 반사를 피하세요.
  </Card>
</CardGroup>

## 기술 요구사항

<AccordionGroup>
  <Accordion title="이미지 형식 사양">
    * **형식**: JPEG, PNG, WebP
    * **최대 크기**: 10MB
    * **최소 해상도**: 640x480 픽셀
    * **종횡비**: 1:1에서 4:3 권장
    * **색 공간**: RGB 또는 sRGB
  </Accordion>

  <Accordion title="Base64 인코딩">
    * MIME 타입 접두사 제거 (예: "image/png;base64,")
    * 표준 base64 인코딩 사용
    * 줄바꿈이나 특수 문자 없음
    * 최대 인코딩 길이: 15MB
  </Accordion>

  <Accordion title="처리 시간">
    * 일반적인 응답 시간: 2-5초
    * 이미지 크기와 서버 부하에 따라 달라질 수 있음
    * 더 큰 이미지는 처리 시간이 더 오래 걸릴 수 있음
  </Accordion>
</AccordionGroup>

## 성공 팁

<Steps>
  <Step title="샘플 이미지로 테스트">
    프로덕션에 구현하기 전에 API를 테스트하기 위해 샘플 이미지를 사용하세요.
  </Step>

  <Step title="재시도 로직 구현">
    임시 문제로 인한 실패한 요청에 대한 재시도 메커니즘을 추가하세요.
  </Step>

  <Step title="응답 시간 모니터링">
    API 응답 시간을 추적하고 필요시 이미지 크기를 조정하세요.
  </Step>

  <Step title="결과 검증">
    항상 실시간 점수를 검증하고 사용 사례에 적절한 임계값을 구현하세요.
  </Step>
</Steps>

<Callout type="warning">
  실시간 감지는 100% 완벽하지 않다는 것을 기억하세요. 항상 추가 보안 조치를 구현하고 실시간 점수를 더 넓은 검증 전략의 일부로 고려하세요.
</Callout>