> ## 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.

# 이미지 모범 사례

> ID Liveness API를 위한 최적의 이미지 품질 가이드라인 및 요구사항

<Callout type="info">
  **이미지 유형 및 크기 요구사항**

  **촬영 이미지 가이드라인**

  **지원되는 신분증 유형**

  **주의사항**
</Callout>

## 이미지 요구사항

### 지원 형식

* **JPEG/JPG**: 가장 일반적으로 사용되는 형식
* **PNG**: 투명도가 있는 이미지에 적합
* **Base64 인코딩**: API 제출 시 필수

### 이미지 품질 가이드라인

#### 해상도 요구사항

* **최소 해상도**: 640x480 픽셀
* **권장 해상도**: 1920x1080 픽셀 이상
* **최대 파일 크기**: 10MB

#### 이미지 촬영 모범 사례

1. **충분한 조명**: 그림자가 생기지 않도록 적절한 조명 확보
2. **명확한 초점**: 이미지가 선명하고 초점이 맞아야 함
3. **전체 문서**: 신분증 문서 전체를 촬영
4. **방해 요소 제거**: 손가락, 반사, 기타 물체가 문서를 가리지 않도록 주의
5. **적절한 각도**: 기울어지지 않은 정면 각도로 촬영

### 지원되는 신분증 유형

#### 정부 발급 신분증

* **여권**: 모든 국가
* **주민등록증/신분증**: 대부분의 국가
* **운전면허증**: 대부분의 국가
* **거주 허가증**: 다양한 국가

#### 사업자 문서

* **법인 등기**: 사업자 등록 문서
* **세무 문서**: 공식 세무 관련 문서

### 중요 주의사항

#### 이미지 처리

* **Base64 인코딩**: 전송 전 MIME 타입 접두사 제거
* **압축 최소화**: 품질을 저하시키는 과도한 압축 피하기
* **원본 형식**: 가능한 경우 원본 이미지 형식 사용

#### 보안 고려사항

* **데이터 보호**: 민감한 문서의 안전한 전송 보장
* **임시 저장**: 필요한 시간보다 오래 이미지를 저장하지 않기
* **접근 제어**: 문서 이미지에 대한 적절한 접근 제어 구현

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

* **흐릿한 이미지**: 카메라가 안정적이고 초점이 맞는지 확인
* **불충분한 조명**: 과도한 노출 또는 노출 부족 피하기
* **불완전한 문서**: 문서 전체를 촬영
* **반사**: 조명이나 카메라 플래시로 인한 눈부심 피하기
* **잘린 내용**: 모든 텍스트와 이미지가 보이는지 확인

## 기술 사양

### Base64 인코딩 예제

```javascript theme={null}
// 올바른 형식 (MIME 타입 제거)
const base64Image = "iVBORw0KGgoAAAANSUhEUgAA...";

// 잘못된 형식 (MIME 타입 포함)
const base64Image = "data:image/jpeg;base64,iVBORw0KGgoAAAANSUhEUgAA...";
```

### 파일 크기 최적화

* **압축**: 품질과 크기의 균형을 맞추기 위해 적절한 압축 사용
* **해상도**: 사용 사례에 맞는 적절한 해상도 선택
* **형식**: JPEG는 일반적으로 사진에 좋은 압축률을 제공

## 테스트 권장사항

### 제출 전 체크리스트

* [ ] 이미지가 최소 해상도 요구사항을 충족하는지 확인
* [ ] 문서가 완전히 보이고 읽을 수 있는지 확인
* [ ] 이미지가 적절히 초점이 맞고 조명이 충분한지 확인
* [ ] Base64 인코딩이 올바른지 확인 (MIME 타입 없음)
* [ ] 파일 크기가 제한 내에 있는지 확인
* [ ] 이미지 형식이 지원되는지 확인

### 품질 평가

* **텍스트 가독성**: 모든 텍스트가 명확하게 읽을 수 있어야 함
* **이미지 선명도**: 문서 이미지가 선명해야 함
* **색상 정확도**: 색상이 정확하고 탁하지 않아야 함
* **아티팩트 없음**: 이미지에 압축 아티팩트가 없어야 함
