La détection de texte effectue une reconnaissance optique des caractères (OCR) Cette opération détecte et extrait le texte d'une vidéo d'entrée.
La détection de texte est disponible pour toutes les langues compatibles avec l'API Cloud Vision.
Effectuer une requête de détection de texte pour une vidéo sur Google Cloud Storage
Les exemples suivants illustrent la détection de texte appliquée à un fichier hébergé dans Cloud Storage.
API REST et ligne de commande
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
. Cet exemple fait intervenir le jeton d'accès associé à un compte de service configuré pour le projet à l'aide du SDK Cloud. Pour obtenir des instructions sur l'installation du SDK Cloud, la configuration d'un projet avec un compte de service et l'obtention d'un jeton d'accès, consultez la page 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-videointelligence-demo/assistant.mp4",
- language-code : [Facultatif] Par exemple, "en-US"
Méthode HTTP et URL :
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corps JSON de la requête :
{ "inputUri": "input-uri", "features": ["TEXT_DETECTION"], "videoContext": { "textDetectionConfig": { "languageHints": ["language-code"] } } }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/project-number/locations/location-id/operations/operation-id" }
Si la réponse aboutit, l'API Video Intelligence renvoie le name
de 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.
- 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 sera déterminé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
.
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 texte sont renvoyées sous la forme d'une listetextAnnotations
.
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.
Télécharger les résultats d'annotation
Copiez l'annotation de la source dans le bucket de destination (consultez la section Copier des fichiers et des objets).
gsutil cp gcs_uri gs://my-bucket
Remarque: Si l'URI de sortie GCS de sortie est fourni par l'utilisateur, l'annotation est stockée dans cet URI gcs.
C#
Go
Java
Node.js
PHP
Python
Ruby
Effectuer une requête de détection de texte pour un fichier vidéo local
Les exemples suivants illustrent la détection de texte sur un fichier stocké en local.
API REST et ligne de commande
Envoyer une requête d'annotation vidéo
Pour effectuer l'annotation d'un fichier vidéo local, veillez à encoder son contenu en base64.
Incluez le contenu encodé en base64 dans le champ inputContent
de la requête.
Pour en savoir plus sur l'encodage du contenu d'un fichier vidéo en base64, consultez la page Encoder en base64.
Vous trouverez ci-dessous la procédure à suivre pour envoyer une requête à la méthode videos:annotate
.
Cet exemple fait intervenir le jeton d'accès associé à un compte de service configuré pour le projet à l'aide du SDK Cloud.
Pour obtenir des instructions sur l'installation du SDK Cloud, la configuration d'un projet avec un compte de service et l'obtention d'un jeton d'accès, consultez la page 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" : base-64-encoded-content
Par exemple :"UklGRg41AwBBVkkgTElTVAwBAABoZHJsYXZpaDgAAAA1ggAAxPMBAAAAAAAQCAA..."
- language-code : [Facultatif] Par exemple, "en-US"
Méthode HTTP et URL :
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corps JSON de la requête :
{ "inputContent": "base-64-encoded-content", "features": ["TEXT_DETECTION"], "videoContext": { "textDetectionConfig": { "languageHints": ["language-code"] } } }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "name": "projects/project-number/locations/location-id/operations/operation-id" }
Si la réponse aboutit, l'API Video Intelligence renvoie le name
de votre opération. L'exemple ci-dessus montre un exemple de ce type de réponse, où project-number
est le nom de votre projet et operation-id
est l'ID de l'opération de longue durée créée pour la requête.
- operation-id : fourni dans la réponse lorsque vous avez démarré 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.
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 texte sont renvoyées sous forme de liste textAnnotations
.
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.
C#
Go
Java
Node.js
PHP