이미지 사양

Amazon Rekognition Image 작업은 .jpg나 .png 형식의 입력 이미지를 분석할 수 있습니다.

직접 호출의 일부로 Amazon Rekognition Image 작업에 이미지 바이트를 전달하거나 기존 Amazon S3 객체를 참조합니다. Amazon S3 버킷에 저장된 이미지를 분석하는 예제는 Amazon S3 버킷에 저장된 이미지 분석 섹션을 참조하세요. 이미지 바이트를 Amazon Rekognition Image API 작업으로 전달하는 예제는 로컬 파일 시스템에서 불러온 이미지 분석 섹션을 참조하세요.

HTTP를 사용하여 Amazon Rekognition Image 작업의 일부로 이미지 바이트를 전달하는 경우 이미지 바이트는 base64로 인코딩된 문자열이어야 합니다. AWS SDK를 사용하여 API 작업 호출의 일부로 이미지 바이트를 전달하는 경우 이미지 바이트를 base64로 인코딩해야 하는지 여부는 사용하는 언어에 따라 달라집니다.

다음의 일반적인 AWS SDK는 이미지를 base64로 자동 인코딩하므로 Amazon Rekognition Image API 작업을 직접 호출하기 전에 이미지 바이트를 인코딩할 필요가 없습니다.

• Java

• JavaScript

• Python

• PHP

다른 AWS SDK를 사용하는 경우 Rekognition API 작업을 직접 호출할 때 이미지 형식 오류가 발생하면 이미지 바이트를 Rekognition API 작업에 전달하기 전에 base64로 인코딩하세요.

AWS CLI를 사용하여 Amazon Rekognition Image 작업을 직접 호출하는 경우 직접 호출의 일부로 이미지 바이트를 전달하는 작업은 지원되지 않습니다. 먼저 이미지를 Amazon S3 버킷에 업로드한 다음 업로드된 이미지를 참조하는 작업을 호출해야 합니다.

참고

이미지 바이트 대신 S3Object에 저장된 이미지를 전달하면 이미지를 base64로 인코딩할 필요가 없습니다.

Amazon Rekognition Image 작업의 지연 시간을 최소화하는 방법에 대한 자세한 내용은 Amazon Rekognition Image 작업 지연 시간 섹션을 참조하세요.

이미지 방향 수정

여러 Rekognition API 작업에서는 분석된 이미지의 방향이 반환됩니다. 이미지 방향을 알면 이미지 방향을 전환하여 표시할 수 있으므로 중요합니다. 얼굴을 분석하는 Rekognition API 작업은 이미지 속의 얼굴 위치에 대한 경계 상자도 반환합니다. 경계 상자를 사용하여 이미지의 얼굴 주위에 상자를 표시할 수 있습니다. 반환된 경계 상자 좌표는 이미지 방향의 영향을 받으며 얼굴 주위에 상자를 올바르게 표시하려면 경계 상자 좌표를 변환해야 할 수도 있습니다. 자세한 설명은 이미지 방향 및 경계 상자 좌표 가져오기 섹션을 참조하세요.

이미지 크기 조정

분석 중에 Amazon Rekognition은 특정 모델 또는 알고리즘에 가장 적합한 사전 정의된 범위 세트를 사용하여 내부적으로 이미지 크기를 조정합니다. 이로 인해 Amazon Rekognition은 입력 이미지의 해상도에 따라 다른 수의 객체를 감지하거나 다른 결과를 내놓을 수 있습니다. 예를 들어 이미지가 두 개 있다고 가정하겠습니다. 첫 번째 이미지의 해상도는 1024x768픽셀입니다. 첫 번째 이미지의 크기가 조정된 버전인 두 번째 이미지의 해상도는 640x480픽셀입니다. 에 이미지를 제출하는 DetectLabels경우 두 호출의 응답이 약간 DetectLabels 다를 수 있습니다.