이 페이지에서는 Vision API를 사용하여 이미지에서 유명인을 인식하는 방법을 설명합니다.
Vision API를 사용하여 이미지에서 얼굴을 감지할 수 있습니다. 얼굴이 인식되면 Vision API가 얼굴을 Google에서 수집한 유명인의 색인 갤러리와 비교할 수 있습니다.
Vision API는 수천 명의 유명인을 인식할 수 있으며, 전문적으로 촬영된 누구나 알아볼 수 있는 유명인이 나오는 미디어 콘텐츠에서만 사용하기 위한 것입니다.
일치하는 얼굴이 발견되면 Vision API는 유명인의 지식 정보 머신 ID(MID), 이름, 이미지에 얼굴이 표시되는 위치를 나타내는 경계 상자를 제공합니다.
API 액세스 요청
이 기능은 전문적으로 제작된 미디어 콘텐츠에서 미디어 및 엔터테인먼트 회사나 승인을 받은 파트너가 사용하기 위한 것입니다. API 액세스를 요청하려면 이 양식에 회사 및 사용 사례에 대한 정보를 작성하여 제출하세요.
로컬 이미지에 대한 유명인 인식 요청
Vision API를 사용하여 로컬 이미지 파일에서 기능 감지를 수행할 수 있습니다.
REST 요청의 경우 이미지 파일의 콘텐츠를 요청 본문에 base64로 인코딩된 문자열로 보냅니다.
gcloud 및 클라이언트 라이브러리 요청의 경우 요청에 로컬 이미지 경로를 지정합니다.
유명인 인식 요청을 보내려면 먼저 프로젝트에서 이 기능에 대한 액세스 권한을 얻은 후에 기존의 얼굴 인식 기능(FACE_DETECTION enum)을 사용하세요.
유명인이 인식되면 결과에 유명인 정보가 포함됩니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- BASE64_ENCODED_IMAGE: 바이너리 이미지 데이터의 base64 표현(ASCII 문자열)입니다. 이 문자열은 다음 문자열과 유사하게 표시됩니다.
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: Google Cloud 프로젝트 ID
HTTP 메서드 및 URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
JSON 요청 본문:
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1p4beta1/images:annotate"
PowerShell
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
원격 이미지에 대한 유명인 인식 요청
Vision API를 사용하여 Cloud Storage 또는 웹에 있는 원격 이미지 파일에서 기능 감지를 수행할 수 있습니다. 원격 파일 요청을 보내려면 요청 본문에 파일의 웹 URL 또는 Cloud Storage URI를 지정합니다.
유명인 인식 요청을 보내려면 먼저 프로젝트에서 이 기능에 대한 액세스 권한을 얻은 후에 기존의 얼굴 인식 기능(FACE_DETECTION enum)을 사용하세요.
유명인이 인식되면 결과에 유명인 정보가 포함됩니다.
REST
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- CLOUD_STORAGE_IMAGE_URI: Cloud Storage 버킷에 있는 유효한 이미지 파일의 경로입니다. 적어도 파일에 대한 읽기 권한이 있어야 합니다.
예를 들면 다음과 같습니다.
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID: Google Cloud 프로젝트 ID
HTTP 메서드 및 URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
JSON 요청 본문:
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://vision.googleapis.com/v1p4beta1/images:annotate"
PowerShell
요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://vision.googleapis.com/v1p4beta1/images:annotate" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
유명인 선택 해제 요청
귀하가 Cloud Vision 또는 Video Intelligence API에서 이 기능에 포함되고 싶지 않은 유명인인 경우에는 이 양식을 작성하여 제출하세요.
오용 신고
Vision API 유명인 인식 기능이 오용된 것으로 의심되는 경우 이 양식을 사용하여 알려주시기 바랍니다.