유명인 인식

이 페이지에서는 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==
    자세한 내용은 base64 인코딩 주제를 참조하세요.
  • 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 유명인 인식 기능이 오용된 것으로 의심되는 경우 이 양식을 사용하여 알려주시기 바랍니다.