Esta página descreve como reconhecer celebridades em imagens através da API Vision.
A API Vision permite-lhe detetar caras numa imagem. Quando reconhece uma cara, a API Vision pode compará-la com uma galeria indexada de celebridades compiladas pela Google.
A API Vision pode reconhecer milhares de celebridades e destina-se a ser usada apenas em conteúdo multimédia fotografado profissionalmente, onde se sabe que aparecem celebridades facilmente reconhecíveis na imagem.
Se for encontrada uma correspondência, a API Vision fornece o ID da máquina do Gráfico de Conhecimento (MID) da celebridade, o respetivo nome e uma caixa delimitadora que indica onde o rosto aparece na imagem.
Peça acesso à API
Esta funcionalidade destina-se a ser usada por empresas de multimédia e entretenimento ou parceiros aprovados em conteúdo multimédia produzido profissionalmente. Para solicitar acesso à API, envie este formulário com informações sobre a sua empresa e exemplo de utilização.
Peça o reconhecimento de celebridades para uma imagem local
Pode usar a API Vision para realizar a deteção de caraterísticas num ficheiro de imagem local.
Para pedidos REST, envie o conteúdo do ficheiro de imagem como uma string codificada em base64 no corpo do pedido.
Para pedidos da gcloud e da biblioteca de cliente, especifique o caminho para uma imagem local no seu pedido.
Para enviar um pedido de reconhecimento de celebridades, primeiro aceda
à funcionalidade para o seu projeto e, em seguida, use a funcionalidade
deteção de caras existente (enumeração FACE_DETECTION).
Os resultados contêm informações sobre celebridades se for detetada uma celebridade.
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- BASE64_ENCODED_IMAGE: a representação base64 (string ASCII) dos dados da imagem binária. Esta string deve ser semelhante à
seguinte string:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- PROJECT_ID: o ID do seu Google Cloud projeto.
Método HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON do pedido:
{
"requests": [
{
"image": {
"content": "BASE64_ENCODED_IMAGE"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte:
Peça o reconhecimento de celebridades para uma imagem remota
Pode usar a API Vision para realizar a deteção de funcionalidades num ficheiro de imagem remoto localizado no Cloud Storage ou na Web. Para enviar um pedido de ficheiro remoto, especifique o URL da Web do ficheiro ou o URI do Google Cloud Storage no corpo do pedido.
Para enviar um pedido de reconhecimento de celebridades, primeiro aceda
à funcionalidade para o seu projeto e, em seguida, use a funcionalidade
deteção de caras existente (enumeração FACE_DETECTION).
Os resultados contêm informações sobre celebridades se for detetada uma celebridade.
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- CLOUD_STORAGE_IMAGE_URI: o caminho para um ficheiro de imagem válido num contentor do Cloud Storage. Tem de ter, pelo menos, privilégios de leitura para o ficheiro.
Exemplo:
gs://my-cloud-bucket/img/celebrity_image.jpg
- PROJECT_ID: o ID do seu Google Cloud projeto.
Método HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON do pedido:
{
"requests": [
{
"image": {
"source": {
"imageUri": "CLOUD_STORAGE_FILE_URI"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte:
Solicite a desativação da funcionalidade de celebridades
Se for uma celebridade e não quiser ser incluída nesta funcionalidade para a API Cloud Vision ou Video Intelligence, preencha e envie este formulário.
Denuncie utilização indevida
Se suspeitar que a funcionalidade de reconhecimento de celebridades da API Vision está a ser usada indevidamente de alguma forma, informe-nos através deste formulário.