En esta página, se describe cómo reconocer a las celebridades en imágenes mediante la API de Vision.
La API de Vision te permite detectar rostros en una imagen. Cuando reconoce un rostro, la API de Vision puede compararlo con una galería indexada de celebridades recopilada por Google.
La API de Vision puede reconocer a miles de celebridades y está diseñada solo para contenido multimedia de fotografías profesionales en el que se sabe que aparecen celebridades reconocibles.
Si se encuentra una coincidencia, la API de Vision proporciona el ID de máquina (MID) del gráfico de conocimiento de la celebridad, su nombre y un cuadro de límite que indica dónde aparece el rostro en la imagen.
Solicita acceso a la API
Esta función se diseñó para que la usen las empresas de medios de comunicación y entretenimiento o socios aprobados que trabajan con contenido multimedia profesional. Para solicitar acceso a la API, envía este formulario con información sobre tu empresa y tu caso práctico.
Solicita Reconocimiento de celebridades para una imagen local
Puedes usar la API de Vision para realizar la detección de características en un archivo de imagen local.
Para las solicitudes de REST, envía el contenido del archivo de imagen como una string codificada en base64 en el cuerpo de tu solicitud.
Para las solicitudes de biblioteca cliente y gcloud, especifica la ruta a una imagen local en tu solicitud.
Para enviar una solicitud de reconocimiento de celebridades, primero debes obtener acceso a la función del proyecto y, luego, usar la función de detección de rostro existente (enumerada como FACE_DETECTION).
Los resultados contienen información de celebridades si se detecta una celebridad.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- BASE64_ENCODED_IMAGE: Es la representación en base64 (string ASCII) de los datos de la imagen binaria. Esta string debería ser similar a la siguiente:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID es el ID del proyecto de Google Cloud.
Método HTTP y URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Cuerpo JSON de la solicitud:
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
$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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Solicita el Reconocimiento de celebridades en una imagen remota
Puedes usar la API de Vision para realizar funciones de detección de características en un archivo de imagen remoto ubicado en Cloud Storage o en la Web. Para enviar una solicitud de archivo remoto, especifica la URL web del archivo o el URI de Cloud Storage en el cuerpo de la solicitud.
Para enviar una solicitud de reconocimiento de celebridades, primero debes obtener acceso a la función del proyecto y, luego, usar la función de detección de rostro existente (enumerada como FACE_DETECTION).
Los resultados contienen información de celebridades si se detecta una celebridad.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- CLOUD_STORAGE_IMAGE_URI: La ruta a un archivo de imagen válido en un depósito de Cloud Storage. Como mínimo, debes tener privilegios de lectura en el archivo.
Ejemplo:
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID es el ID del proyecto de Google Cloud.
Método HTTP y URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Cuerpo JSON de la solicitud:
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
$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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Solicita la exclusión de celebridades
Si eres una celebridad y no deseas que se te incluya en esta función para la API de Cloud Vision o Video Intelligence, completa y envía este formulario.
Denuncia el uso inadecuado
Si sospechas que la función de reconocimiento de celebridades de la API de Vision se está usando de alguna forma inadecuada, avísanos mediante este formulario.