Esta página descreve como reconhecer celebridades em imagens usando a API do Vision.
A API do Vision permite detectar rostos em uma imagem. Ao reconhecer um rosto, a API do Vision pode compará-lo com uma galeria indexada de celebridades coletadas pelo Google.
A API do Vision pode reconhecer milhares de celebridades e destina-se ao uso somente em conteúdo de mídia fotografada profissionalmente, em que celebridades de fácil reconhecimento aparecem na imagem.
Se uma correspondência for encontrada, a API do Vision fornecerá o ID da máquina (MID, na sigla em inglês) do mapa de informações da celebridade, o nome dela e uma caixa delimitadora indicando onde o rosto aparece na imagem.
Solicitar acesso à API
Este recurso destina-se ao uso por empresas de mídia e entretenimento ou por parceiros aprovados que envolve conteúdo de mídia produzido profissionalmente. Para solicitar acesso à API, envie este formulário com informações sobre sua empresa e caso de uso.
Solicitar reconhecimento de celebridade para uma imagem local
A API Vision pode realizar a detecção de recursos em um arquivo de imagem local enviando o conteúdo do arquivo de imagem como uma string codificada em base64 no corpo da sua solicitação.
Para enviar uma solicitação de reconhecimento de celebridade, primeiro você recebe acesso
ao recurso para seu projeto e depois usa o recurso atual
de detecção facial (enum FACE_DETECTION).
Os resultados incluirão informações de celebridades se uma celebridade for detectada.
REST e LINHA DE CMD
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- base64-encoded-image: a representação
base64 (string ASCII) dos dados da imagem binária. Essa string precisa ser semelhante à seguinte:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
Método HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON da solicitação:
{
"requests": [
{
"image": {
"content": "base64-encoded-image"
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate
PowerShell
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
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
Você receberá uma resposta JSON semelhante a esta:
Solicitar reconhecimento de celebridade para uma imagem remota
Para comodidade, a API do Vision pode realizar a detecção de recursos diretamente em um arquivo de imagem localizado no Google Cloud Storage ou na Web, sem a necessidade de enviar o conteúdo do arquivo de imagem no corpo da solicitação.
Para enviar uma solicitação de reconhecimento de celebridade, primeiro você recebe acesso
ao recurso para seu projeto e depois usa o recurso atual
de detecção facial (enum FACE_DETECTION).
Os resultados incluirão informações de celebridades se uma celebridade for detectada.
REST e LINHA DE CMD
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- cloud-storage-image-uri: o caminho para um arquivo de imagem
válido em um bucket do Cloud Storage. Você precisa ter, pelo menos, privilégios de leitura para o arquivo.
Exemplo:
gs://my-cloud-bucket/img/celebrity_image.jpg
Método HTTP e URL:
POST https://vision.googleapis.com/v1p4beta1/images:annotate
Corpo JSON da solicitação:
{
"requests": [
{
"image": {
"source": {
"imageUri": "cloud-storage-image-uri"
}
},
"features": [
{
"type": "FACE_DETECTION"
}
],
"imageContext": {
"faceRecognitionParams": {
"celebritySet": ["builtin/default"]
}
}
}
]
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://vision.googleapis.com/v1p4beta1/images:annotate
PowerShell
Salve o corpo da solicitação em um arquivo chamado request.json
e execute o comando a seguir:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
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
Você receberá uma resposta JSON semelhante a esta:
Solicitar desativação de celebridade
Se você é uma celebridade e não quer ser incluído neste recurso para a API do Cloud Vision ou do Video Intelligence, preencha e envie este formulário.
Denunciar uso indevido
Se você suspeitar que o recurso Reconhecimento de celebridades da API do Vision está sendo usado indevidamente de alguma forma, informe-nos usando este formulário.