本頁面說明如何使用 Vision API 辨識圖片中的名人。
Vision API 可讓您偵測圖片中的臉孔。Vision API 辨識出臉孔後，可以與 Google 彙整的明星索引相簿進行比對。
Vision API 可辨識數千位名人，適用於專業拍攝的媒體內容，且圖片中出現的通常是可辨識的名人。
如果找到相符結果，Vision API 會提供名人的知識圖譜機器 ID (MID)、姓名，以及標示臉部在圖片中位置的邊界框。
要求 API 存取權
這項功能適用於媒體娛樂公司或經核准的合作夥伴，用於專業製作的媒體內容。如要申請 API 存取權，請填寫這份表單，並提供貴公司和用途的相關資訊。
要求對本機圖片執行名人辨識
您可以使用 Vision API 對本機圖片檔執行特徵偵測。
如果是 REST 要求，請在要求主體中，以 base64 編碼字串的形式傳送圖片檔案內容。
如果是 gcloud 和用戶端程式庫要求，請在要求中指定本機圖片的路徑。
如要傳送名人辨識要求，請先取得專案的這項功能存取權，然後使用現有的臉部偵測功能 (FACE_DETECTION 列舉)。如果偵測到名人，結果會包含名人資訊。
REST
使用任何要求資料之前，請先替換以下項目：
- BASE64_ENCODED_IMAGE：二進位圖片資料的 Base64 表示法 (ASCII 字串)。這個字串應類似下列字串：
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID：您的 Google Cloud 專案 ID。
HTTP 方法和網址：
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 或網路上的遠端圖片檔案執行特徵偵測。如要傳送遠端檔案要求，請在要求內文中指定檔案的網頁網址或 Cloud Storage URI。
如要傳送名人辨識要求，請先取得專案的這項功能存取權，然後使用現有的臉部偵測功能 (FACE_DETECTION 列舉)。如果偵測到名人，結果會包含名人資訊。
REST
使用任何要求資料之前，請先替換以下項目：
- CLOUD_STORAGE_IMAGE_URI：Cloud Storage 值區中有效圖片檔案的路徑。您必須至少擁有檔案的讀取權限。
範例：
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID：您的 Google Cloud 專案 ID。
HTTP 方法和網址：
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 名人辨識功能，請填寫這份表單告訴我們。