La fonctionnalité de détection des visages de l'API Video Intelligence recherche les visages dans une vidéo.
Détecter des visages à partir d'un fichier dans Cloud Storage
Les exemples suivants illustrent la détection de visages appliquée à un fichier hébergé dans Cloud Storage.
REST
Envoyer une requête d'annotation vidéo
Vous trouverez ci-dessous la procédure à suivre pour envoyer une requête à la méthode videos:annotate
. L'exemple utilise la Google Cloud CLI pour créer un jeton d'accès. Pour obtenir des instructions sur l'installation de la CLI gcloud, consultez le guide de démarrage rapide de l'API Video Intelligence.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- INPUT_URI : bucket Cloud Storage contenant le fichier que vous souhaitez annoter, y compris son nom. Doit commencer par gs://.
Par exemple : `"inputUri": "gs://cloud-samples-data/video/googlework_short.mp4"` - PROJECT_NUMBER : identifiant numérique de votre projet Google Cloud
Méthode HTTP et URL :
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corps JSON de la requête :
{ "inputUri": "INPUT_URI", "features": ["FACE_DETECTION"] }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Si la réponse aboutit, l'API Video Intelligence renvoie le name
de votre opération. Vous trouverez ci-dessous un exemple de réponse de ce type, où :
- PROJECT_NUMBER : numéro de votre projet.
- LOCATION_ID : région cloud dans laquelle l'annotation doit avoir lieu. Les régions cloud compatibles sont les suivantes :
us-east1
,us-west1
,europe-west1
etasia-east1
. Si aucune région n'est spécifiée, une région est sélectionnée en fonction de l'emplacement du fichier vidéo. - OPERATION_ID : ID de l'opération de longue durée créée pour la requête, qui est fourni dans la réponse renvoyée au démarrage de l'opération, par exemple
12345...
Obtenir des résultats d'annotation
Pour récupérer le résultat de l'opération, exécutez une requête GET en utilisant le nom d'opération renvoyé par l'appel à videos:annotate, comme indiqué dans l'exemple suivant.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- OPERATION_NAME: nom de l'opération tel qu'il a été renvoyé par l'API Video Intelligence. Il est au format suivant :
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
. - PROJECT_NUMBER: identifiant numérique de votre projet Google Cloud
Méthode HTTP et URL :
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Les annotations de détection de visages sont renvoyées sous forme de liste faceAnnotations
.
Remarque : Le champ done n'est renvoyé que lorsque sa valeur est True.
Il n'est pas inclus dans les réponses pour lesquelles l'opération n'est pas terminée.
Java
Pour vous authentifier auprès de Video Intelligence, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour vous authentifier auprès de Video Intelligence, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour vous authentifier auprès de Video Intelligence, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langues supplémentaires
C#: Veuillez suivre les Instructions de configuration de C# sur la page des bibliothèques clientes puis accédez à la page Documentation de référence de Video Intelligence pour .NET
PHP : Veuillez suivre les instructions de configuration pour PHP sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Video Intelligence pour PHP.
Ruby : Veuillez suivre les instructions de configuration pour Ruby sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Video Intelligence pour Ruby.
Détecter des visages à partir d'un fichier local
L'exemple suivant utilise la détection de visages pour rechercher des entités dans un fichier vidéo importé depuis votre ordinateur local.
REST
Envoyer la requête de processus
Pour effectuer une détection de visages sur un fichier vidéo local, encodez son contenu en base64. Pour en savoir plus sur l'encodage du contenu d'un fichier vidéo en base64, consultez la page Encoder en base64. Envoyez ensuite une requête POST à la méthode videos:annotate
. Incluez le contenu encodé en base64 dans le champ inputContent
de la requête et spécifiez la fonctionnalité FACE_DETECTION
.
Voici un exemple de requête POST effectuée avec curl. Cet exemple utilise la Google Cloud CLI pour créer un jeton d'accès. Pour savoir comment installer gcloud CLI, consultez la Guide de démarrage rapide de l'API Video Intelligence
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- inputContent: Fichier vidéo local au format binaire
Par exemple: 'AAAAGGZ0eXBtcDQyAAAAAGlzb21tcDQyAAGVYW1vb3YAAABsbXZoZAAAAADWvhlR1r4ZUQABX5ABCOxo AAEAAAEAAAAAAA4...' - PROJECT_NUMBER: identifiant numérique de votre projet Google Cloud
Méthode HTTP et URL :
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corps JSON de la requête :
{ inputContent: "Local video file in binary format", "features": ["FACE_DETECTION"] }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Si la requête aboutit, Video Intelligence renvoie le name
correspond à votre opération. L'exemple ci-dessus montre un exemple de ce type de réponse, où project-number
est le numéro de votre projet et operation-id
est l'ID de l'opération de longue durée créée pour la requête.
{
"name": "us-west1.17122464255125931980"
}
Obtenir les résultats
Pour récupérer le résultat de l'opération, envoyez une requête GET au point de terminaison operations
et spécifiez le nom de votre opération.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- OPERATION_NAME: nom de l'opération tel qu'il a été renvoyé par l'API Video Intelligence. Il est au format suivant :
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
. - PROJECT_NUMBER: identifiant numérique de votre projet Google Cloud
Méthode HTTP et URL :
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
Java
Pour vous authentifier auprès de Video Intelligence, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour vous authentifier auprès de Video Intelligence, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour vous authentifier auprès de Video Intelligence, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langues supplémentaires
C#: Veuillez suivre les Instructions de configuration de C# sur la page des bibliothèques clientes puis accédez à la page Documentation de référence de Video Intelligence pour .NET
PHP : Veuillez suivre les instructions de configuration pour PHP sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Video Intelligence pour PHP.
Ruby: Veuillez suivre les Instructions de configuration de Ruby sur la page des bibliothèques clientes puis accédez à la page Documentation de référence de Video Intelligence pour Ruby