기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이미지 속 유명 인사 인식
이미지 속 유명 인사를 인식하고, 인식한 유명 인사에 대한 추가 정보를 얻으려면 [RecognizeCelebrities](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_RecognizeCelebrities.html) 비 스토리지 API 작업을 사용하세요. 예를 들어 정보 수집 타이밍이 중요한 소셜 미디어 또는 뉴스 및 엔터테인먼트 업계에서는 `RecognizeCelebrities` 작업을 사용하여 한 이미지에서 무려 64명의 유명 인사를 식별하고 유명 인사의 웹 페이지가 있다면 그 링크를 반환할 수 있습니다. Amazon Rekognition은 어떤 이미지에서 유명 인사를 감지했는지 기억하지 않습니다. 애플리케이션에서 이 정보를 저장해야 합니다.
`RecognizeCelebrities`에서 반환한 유명 인사에 대한 추가 정보를 저장하지 않은 상태에서 해당 정보를 얻기 위해 이미지를 재분석하는 것을 피하려면 [GetCelebrityInfo](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityInfo.html)를 사용하세요. `GetCelebrityInfo`를 직접적으로 호출하려면 Amazon Rekognition이 각 유명 인사에게 할당하는 고유한 식별자가 필요합니다. 식별자는 이미지에서 인식된 각 유명 인사에 대한 `RecognizeCelebrities` 응답의 일부로 반환됩니다.
유명 인사 인식을 위해 처리할 이미지 모음이 많은 경우, [AWS Batch](https://docs.aws.amazon.com/batch/latest/userguide/)를 사용해 백그라운드에서 일괄적으로 `RecognizeCelebrities`에 대한 호출을 처리하는 방법을 고려하십시오. 컬렉션에 새 이미지를 추가할 때 AWS Lambda 함수를 사용하여 이미지가 S3 버킷에 업로드`RecognizeCelebrities`될 때를 호출하여 유명 인사를 인식할 수 있습니다.
## RecognizeCelebrities 호출
AWS Command Line Interface () 또는 AWS SDK를 사용하여 입력 이미지를 이미지 바이트 배열(base64 인코딩 이미지 바이트AWS CLI) 또는 Amazon S3 객체로 제공할 수 있습니다. 이 AWS CLI 절차에서는 .jpg 또는 .png 형식의 이미지를 S3 버킷에 업로드합니다. AWS SDK 절차에서는 로컬 파일 시스템에서 로드된 이미지를 사용합니다. 입력 이미지 권장 사항에 대한 자세한 내용은 [이미지 작업](images.md) 단원을 참조하십시오.
이 절차를 실행하려면 에서 한 명 이상의 유명 인사 얼굴이 포함된 이미지 파일이 필요합니다.
**이미지에서 유명인 인식**
1. 아직 설정하지 않았다면 다음과 같이 하세요.
1. `AmazonRekognitionFullAccess` 권한과 `AmazonS3ReadOnlyAccess` 권한을 가진 사용자를 생성하거나 업데이트합니다. 자세한 내용은 [1단계: AWS 계정 설정 및 사용자 생성](setting-up.md#setting-up-iam) 단원을 참조하십시오.
1. AWS CLI 및 AWS SDKs를 설치하고 구성합니다. 자세한 내용은 [2단계: AWS CLI 및 AWS SDKs 설정](setup-awscli-sdk.md) 단원을 참조하십시오.
1. 다음 예제를 사용하여 `RecognizeCelebrities` 작업을 호출합니다.
------
#### [ Java ]
이 예제는 이미지에서 감지된 유명 인사에 대한 정보를 표시합니다.
`photo`의 값을, 하나 이상의 유명 인사 얼굴을 포함하는 이미지 파일의 경로와 파일 이름으로 변경합니다.
```
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
package aws.example.rekognition.image;
import com.amazonaws.services.rekognition.AmazonRekognition;
import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
import com.amazonaws.services.rekognition.model.Image;
import com.amazonaws.services.rekognition.model.BoundingBox;
import com.amazonaws.services.rekognition.model.Celebrity;
import com.amazonaws.services.rekognition.model.RecognizeCelebritiesRequest;
import com.amazonaws.services.rekognition.model.RecognizeCelebritiesResult;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.nio.ByteBuffer;
import com.amazonaws.util.IOUtils;
import java.util.List;
public class RecognizeCelebrities {
public static void main(String[] args) {
String photo = "moviestars.jpg";
AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
ByteBuffer imageBytes=null;
try (InputStream inputStream = new FileInputStream(new File(photo))) {
imageBytes = ByteBuffer.wrap(IOUtils.toByteArray(inputStream));
}
catch(Exception e)
{
System.out.println("Failed to load file " + photo);
System.exit(1);
}
RecognizeCelebritiesRequest request = new RecognizeCelebritiesRequest()
.withImage(new Image()
.withBytes(imageBytes));
System.out.println("Looking for celebrities in image " + photo + "\n");
RecognizeCelebritiesResult result=rekognitionClient.recognizeCelebrities(request);
//Display recognized celebrity information
List celebs=result.getCelebrityFaces();
System.out.println(celebs.size() + " celebrity(s) were recognized.\n");
for (Celebrity celebrity: celebs) {
System.out.println("Celebrity recognized: " + celebrity.getName());
System.out.println("Celebrity ID: " + celebrity.getId());
BoundingBox boundingBox=celebrity.getFace().getBoundingBox();
System.out.println("position: " +
boundingBox.getLeft().toString() + " " +
boundingBox.getTop().toString());
System.out.println("Further information (if available):");
for (String url: celebrity.getUrls()){
System.out.println(url);
}
System.out.println();
}
System.out.println(result.getUnrecognizedFaces().size() + " face(s) were unrecognized.");
}
}
```
------
#### [ Java V2 ]
이 코드는 AWS 설명서 SDK 예제 GitHub 리포지토리에서 가져온 것입니다. 전체 예제는 [여기](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/rekognition/src/main/java/com/example/rekognition/RecognizeCelebrities.java)에서 확인하세요.
```
//snippet-start:[rekognition.java2.recognize_celebs.import]
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rekognition.RekognitionClient;
import software.amazon.awssdk.core.SdkBytes;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;
import java.util.List;
import software.amazon.awssdk.services.rekognition.model.RecognizeCelebritiesRequest;
import software.amazon.awssdk.services.rekognition.model.RecognizeCelebritiesResponse;
import software.amazon.awssdk.services.rekognition.model.RekognitionException;
import software.amazon.awssdk.services.rekognition.model.Image;
import software.amazon.awssdk.services.rekognition.model.Celebrity;
//snippet-end:[rekognition.java2.recognize_celebs.import]
/**
* Before running this Java V2 code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class RecognizeCelebrities {
public static void main(String[] args) {
final String usage = "\n" +
"Usage: " +
" \n\n" +
"Where:\n" +
" sourceImage - The path to the image (for example, C:\\AWS\\pic1.png). \n\n";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String sourceImage = args[0];
Region region = Region.US_EAST_1;
RekognitionClient rekClient = RekognitionClient.builder()
.region(region)
.credentialsProvider(ProfileCredentialsProvider.create("profile-name"))
.build();
System.out.println("Locating celebrities in " + sourceImage);
recognizeAllCelebrities(rekClient, sourceImage);
rekClient.close();
}
// snippet-start:[rekognition.java2.recognize_celebs.main]
public static void recognizeAllCelebrities(RekognitionClient rekClient, String sourceImage) {
try {
InputStream sourceStream = new FileInputStream(sourceImage);
SdkBytes sourceBytes = SdkBytes.fromInputStream(sourceStream);
Image souImage = Image.builder()
.bytes(sourceBytes)
.build();
RecognizeCelebritiesRequest request = RecognizeCelebritiesRequest.builder()
.image(souImage)
.build();
RecognizeCelebritiesResponse result = rekClient.recognizeCelebrities(request) ;
List celebs=result.celebrityFaces();
System.out.println(celebs.size() + " celebrity(s) were recognized.\n");
for (Celebrity celebrity: celebs) {
System.out.println("Celebrity recognized: " + celebrity.name());
System.out.println("Celebrity ID: " + celebrity.id());
System.out.println("Further information (if available):");
for (String url: celebrity.urls()){
System.out.println(url);
}
System.out.println();
}
System.out.println(result.unrecognizedFaces().size() + " face(s) were unrecognized.");
} catch (RekognitionException | FileNotFoundException e) {
System.out.println(e.getMessage());
System.exit(1);
}
}
// snippet-end:[rekognition.java2.recognize_celebs.main]
}
```
------
#### [ AWS CLI ]
이 AWS CLI 명령은 `recognize-celebrities` CLI 작업에 대한 JSON 출력을 표시합니다.
`amzn-s3-demo-bucket`을 이미지가 저장된 Amazon S3 버킷의 이름으로 변경합니다. `input.jpg`를 하나 이상의 유명 인사 얼굴을 포함하는 이미지 파일의 이름으로 변경합니다.
`profile_name`의 값을 개발자 프로필 이름으로 바꿉니다.
```
aws rekognition recognize-celebrities \
--image "S3Object={Bucket=amzn-s3-demo-bucket,Name=input.jpg}"
```
Windows 디바이스에서 CLI에 액세스하는 경우 작은따옴표 대신 큰따옴표를 사용하고 내부 큰따옴표는 백슬래시(즉 \$1)로 이스케이프 처리하여 발생할 수 있는 구문 분석 오류를 해결합니다. 예를 들어 다음을 참조하세요.
```
aws rekognition recognize-celebrities --image \
"{\"S3Object\":{\"Bucket\":\"amzn-s3-demo-bucket\",\"Name\":\"image-name\"}}" --profile profile-name
```
------
#### [ Python ]
이 예제는 이미지에서 감지된 유명 인사에 대한 정보를 표시합니다.
`photo`의 값을, 하나 이상의 유명 인사 얼굴을 포함하는 이미지 파일의 경로와 파일 이름으로 변경합니다.
Rekognition 세션을 생성하는 라인에서 `profile_name`의 값을 개발자 프로필의 이름으로 대체합니다.
```
#Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
import boto3
def recognize_celebrities(photo):
session = boto3.Session(profile_name='profile-name')
client = session.client('rekognition')
with open(photo, 'rb') as image:
response = client.recognize_celebrities(Image={'Bytes': image.read()})
print('Detected faces for ' + photo)
for celebrity in response['CelebrityFaces']:
print('Name: ' + celebrity['Name'])
print('Id: ' + celebrity['Id'])
print('KnownGender: ' + celebrity['KnownGender']['Type'])
print('Smile: ' + str(celebrity['Face']['Smile']['Value']))
print('Position:')
print(' Left: ' + '{:.2f}'.format(celebrity['Face']['BoundingBox']['Height']))
print(' Top: ' + '{:.2f}'.format(celebrity['Face']['BoundingBox']['Top']))
print('Info')
for url in celebrity['Urls']:
print(' ' + url)
print()
return len(response['CelebrityFaces'])
def main():
photo = 'photo-name'
celeb_count = recognize_celebrities(photo)
print("Celebrities detected: " + str(celeb_count))
if __name__ == "__main__":
main()
```
------
#### [ Node.Js ]
이 예제는 이미지에서 감지된 유명 인사에 대한 정보를 표시합니다.
`photo`의 값을, 하나 이상의 유명 인사 얼굴을 포함하는 이미지 파일의 경로와 파일 이름으로 변경합니다. `amzn-s3-demo-bucket`의 값을 제공된 이미지 파일이 저장된 S3 버킷의 이름으로 바꿉니다. `REGION`의 값을 사용자와 연결된 지역 이름으로 변경합니다. Rekognition 세션을 생성하는 라인에서 `profile_name`의 값을 개발자 프로필의 이름으로 대체합니다.
```
// Import required AWS SDK clients and commands for Node.js
import { RecognizeCelebritiesCommand } from "@aws-sdk/client-rekognition";
import { RekognitionClient } from "@aws-sdk/client-rekognition";
// Set the AWS Region.
const REGION = "region-name"; //e.g. "us-east-1"
const profileName = "profile-name";
// Create SNS service object.
const rekogClient = new RekognitionClient({region: REGION,
credentials: fromIni({profile: profileName,}),
});
const bucket = 'bucket-name'
const photo = 'photo-name'
// Set params
const params = {
Image: {
S3Object: {
Bucket: bucket,
Name: photo
},
},
}
const recognize_celebrity = async() => {
try {
const response = await rekogClient.send(new RecognizeCelebritiesCommand(params));
console.log(response.Labels)
response.CelebrityFaces.forEach(celebrity =>{
console.log(`Name: ${celebrity.Name}`)
console.log(`ID: ${celebrity.Id}`)
console.log(`KnownGender: ${celebrity.KnownGender.Type}`)
console.log(`Smile: ${celebrity.Smile}`)
console.log('Position: ')
console.log(` Left: ${celebrity.Face.BoundingBox.Height}`)
console.log(` Top : ${celebrity.Face.BoundingBox.Top}`)
})
return response.length; // For unit tests.
} catch (err) {
console.log("Error", err);
}
}
recognize_celebrity()
```
------
#### [ .NET ]
이 예제는 이미지에서 감지된 유명 인사에 대한 정보를 표시합니다.
`photo`의 값을, 하나 이상의 유명 인사 얼굴(.jpg 또는 .png 형식)을 포함하는 이미지 파일의 경로와 파일 이름으로 변경합니다.
```
//Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
//PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.)
using System;
using System.IO;
using Amazon.Rekognition;
using Amazon.Rekognition.Model;
public class CelebritiesInImage
{
public static void Example()
{
String photo = "moviestars.jpg";
AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient();
RecognizeCelebritiesRequest recognizeCelebritiesRequest = new RecognizeCelebritiesRequest();
Amazon.Rekognition.Model.Image img = new Amazon.Rekognition.Model.Image();
byte[] data = null;
try
{
using (FileStream fs = new FileStream(photo, FileMode.Open, FileAccess.Read))
{
data = new byte[fs.Length];
fs.Read(data, 0, (int)fs.Length);
}
}
catch(Exception)
{
Console.WriteLine("Failed to load file " + photo);
return;
}
img.Bytes = new MemoryStream(data);
recognizeCelebritiesRequest.Image = img;
Console.WriteLine("Looking for celebrities in image " + photo + "\n");
RecognizeCelebritiesResponse recognizeCelebritiesResponse = rekognitionClient.RecognizeCelebrities(recognizeCelebritiesRequest);
Console.WriteLine(recognizeCelebritiesResponse.CelebrityFaces.Count + " celebrity(s) were recognized.\n");
foreach (Celebrity celebrity in recognizeCelebritiesResponse.CelebrityFaces)
{
Console.WriteLine("Celebrity recognized: " + celebrity.Name);
Console.WriteLine("Celebrity ID: " + celebrity.Id);
BoundingBox boundingBox = celebrity.Face.BoundingBox;
Console.WriteLine("position: " +
boundingBox.Left + " " + boundingBox.Top);
Console.WriteLine("Further information (if available):");
foreach (String url in celebrity.Urls)
Console.WriteLine(url);
}
Console.WriteLine(recognizeCelebritiesResponse.UnrecognizedFaces.Count + " face(s) were unrecognized.");
}
}
```
------
1. 표시되는 유명 인사 ID 중 하나의 값을 기록합니다. [유명 인사에 대한 정보 얻기](get-celebrity-info-procedure.md)에서 이 값이 필요할 것입니다.
## RecognizeCelebrities 작업 요청
`RecognizeCelebrities`에 대한 입력은 이미지입니다. 이 예에서는 이미지가 이미지 바이트로 전달됩니다. 자세한 내용은 [이미지 작업](images.md) 단원을 참조하십시오.
```
{
"Image": {
"Bytes": "/AoSiyvFpm....."
}
}
```
## RecognizeCelebrities 작업 응답
다음은 `RecognizeCelebrities`에 대한 예제 JSON 입력 및 출력입니다.
`RecognizeCelebrities`는 인식된 유명 인사의 배열과 인식되지 않는 얼굴의 배열을 반환합니다. 예제에서 다음 사항에 유의하십시오.
+ **인식된 유명 인사** – `Celebrities`는 인식된 유명 인사의 배열입니다. 배열의 각 [Celebrity](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Celebritiy.html) 객체에는 유명 인사 이름과 관련 콘텐츠를 가리키는 URL 목록(예: 유명인의 IMDB 또는 Wikidata 링크)이 포함됩니다. Amazon Rekognition은 애플리케이션이 이미지에서 유명 인사의 얼굴 위치를 확인하는 데 사용할 수 있는 [ComparedFace](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ComparedFace.html) 객체와 유명 인사의 고유 식별자를 반환합니다. 나중에 [GetCelebrityInfo](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityInfo.html) API 작업으로 유명 인사 정보를 검색하려면 이 고유한 식별자를 사용합니다.
+ **인식되지 않는 얼굴** – `UnrecognizedFaces`는 알려진 유명 인사 누구와도 일치하지 않는 얼굴의 배열입니다. 배열의 각 [ComparedFace](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ComparedFace.html) 객체에는 이미지 속에서 얼굴을 찾는 데 사용할 수 있는 경계 상자가(기타 정보와 함께) 포함되어 있습니다.
```
{
"CelebrityFaces": [{
"Face": {
"BoundingBox": {
"Height": 0.617123007774353,
"Left": 0.15641026198863983,
"Top": 0.10864841192960739,
"Width": 0.3641025722026825
},
"Confidence": 99.99589538574219,
"Emotions": [{
"Confidence": 96.3981749057023,
"Type": "Happy"
}
],
"Landmarks": [{
"Type": "eyeLeft",
"X": 0.2837241291999817,
"Y": 0.3637104034423828
}, {
"Type": "eyeRight",
"X": 0.4091649055480957,
"Y": 0.37378931045532227
}, {
"Type": "nose",
"X": 0.35267341136932373,
"Y": 0.49657556414604187
}, {
"Type": "mouthLeft",
"X": 0.2786353826522827,
"Y": 0.5455248355865479
}, {
"Type": "mouthRight",
"X": 0.39566439390182495,
"Y": 0.5597742199897766
}],
"Pose": {
"Pitch": -7.749263763427734,
"Roll": 2.004552125930786,
"Yaw": 9.012002944946289
},
"Quality": {
"Brightness": 32.69192123413086,
"Sharpness": 99.9305191040039
},
"Smile": {
"Confidence": 95.45394855702342,
"Value": True
}
},
"Id": "3Ir0du6",
"KnownGender": {
"Type": "Male"
},
"MatchConfidence": 98.0,
"Name": "Jeff Bezos",
"Urls": ["www.imdb.com/name/nm1757263"]
}],
"OrientationCorrection": "NULL",
"UnrecognizedFaces": [{
"BoundingBox": {
"Height": 0.5345501899719238,
"Left": 0.48461538553237915,
"Top": 0.16949152946472168,
"Width": 0.3153846263885498
},
"Confidence": 99.92860412597656,
"Landmarks": [{
"Type": "eyeLeft",
"X": 0.5863404870033264,
"Y": 0.36940744519233704
}, {
"Type": "eyeRight",
"X": 0.6999204754829407,
"Y": 0.3769848346710205
}, {
"Type": "nose",
"X": 0.6349524259567261,
"Y": 0.4804527163505554
}, {
"Type": "mouthLeft",
"X": 0.5872702598571777,
"Y": 0.5535582304000854
}, {
"Type": "mouthRight",
"X": 0.6952020525932312,
"Y": 0.5600858926773071
}],
"Pose": {
"Pitch": -7.386096477508545,
"Roll": 2.304218292236328,
"Yaw": -6.175624370574951
},
"Quality": {
"Brightness": 37.16635513305664,
"Sharpness": 99.9305191040039
},
"Smile": {
"Confidence": 95.45394855702342,
"Value": True
}
}]
}
```