유명인 인식

이 페이지에서는 Vision API를 사용하여 이미지에서 유명인을 인식하는 방법을 설명합니다.

Vision API를 사용하여 이미지에서 얼굴을 감지할 수 있습니다. 얼굴이 인식되면 Vision API가 얼굴을 Google에서 수집한 유명인의 색인 갤러리와 비교할 수 있습니다.

Vision API는 수천 명의 유명인을 인식할 수 있으며, 전문적으로 촬영된 누구나 알아볼 수 있는 유명인이 나오는 미디어 콘텐츠에서만 사용하기 위한 것입니다.

일치하는 얼굴이 발견되면 Vision API는 유명인의 지식 정보 머신 ID(MID), 이름, 이미지에 얼굴이 표시되는 위치를 나타내는 경계 상자를 제공합니다.

API 액세스 요청

이 기능은 전문적으로 제작된 미디어 콘텐츠에서 미디어 및 엔터테인먼트 회사나 승인을 받은 파트너가 사용하기 위한 것입니다. API 액세스를 요청하려면 이 양식에 회사 및 사용 사례에 대한 정보를 작성하여 제출하세요.

로컬 이미지에 대한 유명인 인식 요청

Vision API는 이미지 파일의 콘텐츠를 요청 본문에 base64로 인코딩된 문자열로 전송하여 로컬 이미지 파일에서 기능 감지를 수행할 수 있습니다.

유명인 인식 요청을 보내려면 먼저 프로젝트에서 이 기능에 대한 액세스 권한을 얻은 후에 기존의 얼굴 인식 기능(FACE_DETECTION enum)을 사용하세요. 유명인이 인식되면 결과에 유명인 정보가 포함됩니다.

REST 및 명령줄

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • base64-encoded-image: 바이너리 이미지 데이터의 base64 표현(ASCII 문자열)입니다. 이 문자열은 다음 문자열과 비슷해야 합니다.
    • /9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
    자세한 내용은 base64 인코딩 주제를 참조하세요.

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 application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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는 요청 본문 안에 이미지 파일의 콘텐츠를 보내지 않고도 Google Cloud Storage 또는 웹에 위치한 이미지 파일에서 바로 특징 감지를 수행할 수 있습니다.

유명인 인식 요청을 보내려면 먼저 프로젝트에서 이 기능에 대한 액세스 권한을 얻은 후에 기존의 얼굴 인식 기능(FACE_DETECTION enum)을 사용하세요. 유명인이 인식되면 결과에 유명인 정보가 포함됩니다.

REST 및 명령줄

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • cloud-storage-image-uri: Cloud Storage 버킷에 있는 유효한 이미지 파일의 경로입니다. 적어도 파일에 대한 읽기 권한이 있어야 합니다. 예를 들면 다음과 같습니다.
    • gs://my-cloud-bucket/img/celebrity_image.jpg

HTTP 메서드 및 URL:

POST https://vision.googleapis.com/v1p4beta1/images:annotate

JSON 요청 본문:

{
  "requests": [
    {
      "image": {
        "source": {
          "imageUri": "cloud-storage-image-uri"
        }
      },
      "features": [
        {
          "type": "FACE_DETECTION"
        }
      ],
      "imageContext": {
        "faceRecognitionParams": {
            "celebritySet": ["builtin/default"]
        }
      }
    }
  ]
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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 유명인 인식 기능이 오용된 것으로 의심되는 경우 이 양식을 사용하여 알려주시기 바랍니다.