Auf dieser Seite wird beschrieben, wie Sie Prominente mithilfe der Vision API in Bildern erkennen.
Mit der Vision API können Sie Gesichter in einem Bild erkennen. Wenn ein Gesicht erkannt wird, kann die Vision API das Gesicht mit einer indexierten Galerie von Prominenten abgleichen, die von Google zusammengestellt wurde.
Mit der Vision API können Tausende von Prominenten erkannt werden. Sie ist ausschließlich dafür vorgesehen, professionelle Fotos der Medienindustrie zu analysieren, auf denen sehr bekannte Prominente zu sehen sind.
Wenn eine Übereinstimmung gefunden wird, stellt die Vision API die Knowledge Graph-Maschinen-ID (MID) des Prominenten sowie dessen Namen und einen Begrenzungsrahmen bereit, der angibt, wo das Gesicht im Bild zu sehen ist.
API-Zugriff anfordern
Dieses Feature ist für Medien- und Unterhaltungsunternehmen bzw. deren autorisierte Partner in Bezug auf professionell erstellte Medieninhalte vorgesehen. Um den API-Zugriff anzufordern, reichen Sie dieses Formular mit Informationen über Ihr Unternehmen und Ihren Anwendungsfall ein.
Prominentenerkennung für ein lokales Bild anfordern
Sie können die Vision API für die Featureerkennung in einer lokalen Bilddatei verwenden.
Senden Sie bei REST-Anfragen den Inhalt der Bilddatei als base64-codierten String im Text Ihrer Anfrage.
Geben Sie für Anfragen zu gcloud und Clientbibliotheken den Pfad zu einem lokalen Image in Ihrer Anfrage an.
Wenn Sie eine Anfrage zur Prominentenerkennung senden möchten, müssen Sie zuerst für Ihr Projekt Zugriff auf das Feature erhalten und dann das vorhandene Feature zur Gesichtserkennung (FACE_DETECTION-enum) verwenden.
Die Ergebnisse enthalten Prominenteninformationen, wenn ein Prominenter erkannt wurde.
REST
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- BASE64_ENCODED_IMAGE: Die Base64-Darstellung (ASCII-String) der Binärbilddaten. Dieser String sollte in etwa so aussehen:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: Ihre Google Cloud-Projekt-ID.
HTTP-Methode und URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
JSON-Text der Anfrage:
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
$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
Sie sollten in etwa folgende JSON-Antwort erhalten:
Prominentenerkennung für ein Remote-Bild anfordern
Sie können die Vision API verwenden, um eine Featureerkennung für eine Remote-Bilddatei durchzuführen, die sich in Cloud Storage oder im Web befindet. Zum Senden einer Remote-Dateianfrage geben Sie die Web-URL oder den Cloud Storage-URI der Datei im Anfragetext an.
Wenn Sie eine Anfrage zur Prominentenerkennung senden möchten, müssen Sie zuerst für Ihr Projekt Zugriff auf das Feature erhalten und dann das vorhandene Feature zur Gesichtserkennung (FACE_DETECTION-enum) verwenden.
Die Ergebnisse enthalten Prominenteninformationen, wenn ein Prominenter erkannt wurde.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- CLOUD_STORAGE_IMAGE_URI: Der Pfad zu einer gültigen Bilddatei in einem Cloud Storage-Bucket. Sie müssen zumindest Leseberechtigungen für die Datei haben.
Beispiel:
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID: Ihre Google Cloud-Projekt-ID.
HTTP-Methode und URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
JSON-Text der Anfrage:
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
$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
Sie sollten in etwa folgende JSON-Antwort erhalten:
Löschen eines Prominenten aus der Feature-Galerie beantragen
Wenn Sie eine prominente Person sind und nicht möchten, dass Ihr Gesicht über die Cloud Vision API oder die Video Intelligence API von diesem Feature erkannt wird, füllen Sie bitte dieses Formular aus und reichen Sie es ein.
Missbrauch melden
Wenn Sie vermuten, dass das Feature zur Prominentenerkennung der Vision API auf irgendeine Weise missbräuchlich verwendet wird, teilen Sie uns dies bitte über dieses Formular mit.