En esta página se describe cómo reconocer a famosos en imágenes con la API Vision.
La API Vision te permite detectar caras en una imagen. Cuando reconoce una cara, la API Vision puede compararla con una galería indexada de famosos recopilada por Google.
La API Vision puede reconocer a miles de famosos y está diseñada para usarse únicamente en contenido multimedia fotografiado de forma profesional en el que se sabe que aparecen famosos que se reconocen fácilmente.
Si se encuentra una coincidencia, la API Vision proporciona el ID de máquina del gráfico de conocimiento (MID) de la persona famosa, su nombre y un cuadro delimitador que indica dónde aparece la cara en la imagen.
Solicitar acceso a la API
Esta función está pensada para empresas de medios y entretenimiento, o para partners aprobados, que produzcan contenido multimedia de forma profesional. Para solicitar acceso a la API, envía este formulario con información sobre tu empresa y tu caso práctico.
Solicitar el reconocimiento de famosos en una imagen local
Puedes usar la API Vision para detectar rasgos en un archivo de imagen local.
En el caso de las solicitudes REST, envíe el contenido del archivo de imagen como una cadena codificada en Base64 en el cuerpo de la solicitud.
En el caso de las solicitudes de gcloud y de bibliotecas de cliente, especifica la ruta a una imagen local en tu solicitud.
Para enviar una solicitud de reconocimiento de famosos, primero debes obtener acceso
a la función de tu proyecto y, después, usar la función de detección de caras (enum FACE_DETECTION).
Los resultados contienen información sobre famosos si se detecta alguno.
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- BASE64_ENCODED_IMAGE: representación en base64 (cadena ASCII) de los datos de imagen binarios. Esta cadena debe ser similar a la siguiente:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: tu ID de proyecto 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 siguiente:
Solicitar el reconocimiento de famosos en una imagen remota
Puede usar la API Vision para detectar características en un archivo de imagen remoto que se encuentre en Cloud Storage o en la Web. Para enviar una solicitud de archivo remoto, especifica la URL web o el URI de Cloud Storage del archivo en el cuerpo de la solicitud.
Para enviar una solicitud de reconocimiento de famosos, primero debes obtener acceso
a la función de tu proyecto y, después, usar la función de detección de caras (enum FACE_DETECTION).
Los resultados contienen información sobre famosos si se detecta alguno.
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
- CLOUD_STORAGE_IMAGE_URI: la ruta a un archivo de imagen válido en un segmento de Cloud Storage. Debe tener al menos privilegios de lectura en el archivo.
Ejemplo:
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID: tu ID de proyecto 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 siguiente:
Solicitar la inhabilitación de famosos
Si eres una persona famosa y no quieres que se te incluya en esta función de la API Cloud Vision o de la API Video Intelligence, rellena y envía este formulario.
Denunciar un uso inadecuado
Si sospechas que la función de reconocimiento de famosos de la API Vision se está usando de forma inadecuada, infórmanos a través de este formulario.