Gérer les modèles
Un modèle est entraîné à l'aide d'un ensemble de données préparé que vous fournissez. La classification AutoML Video Intelligence utilise les éléments de votre ensemble de données pour entraîner, tester et evaluate les performances du modèle. Ensuite, vous devez examiner les résultats, ajuster l'ensemble de données d'entraînement si nécessaire et entraîner un nouveau modèle à l'aide de l'ensemble de données amélioré.
L'entraînement d'un modèle peut prendre plusieurs heures. L'API AutoML vous permet de vérifier l'état de l'entraînement.
Étant donné que la classification AutoML Video Intelligence crée un modèle chaque fois que vous démarrez l'entraînement, votre projet peut inclure de nombreux modèles. Vous pouvez obtenir la liste des modèles de votre projet et supprimer les modèles dont vous n'avez plus besoin.
La durée de vie maximale d'un modèle est de deux ans. Vous devez créer un modèle et l'entraîner pour continuer à classifier le contenu au-delà de cette période.
Utiliser curl ou PowerShell
Pour faciliter l'exécution des exemples curl
(ou PowerShell) sur cette page, définissez la variable d'environnement suivante. Remplacez project-id par le nom de votre projet Google Cloud.
export PROJECT_ID="project-id"
Entraîner des modèles
Dès lors que vous disposez d'un ensemble de données associé à des éléments d'entraînement fiables et dotés de libellés, vous êtes prêt à créer un modèle et à l'entraîner.
UI Web
-
Ouvrez l'interface utilisateur d'AutoML Video, puis accédez à la page Ensembles de données.
-
Sélectionnez l'ensemble de données que vous voulez utiliser pour entraîner le modèle.
Le nom à afficher de l'ensemble de données sélectionné apparaît dans la barre de titre. La page répertorie chaque élément de l'ensemble de données et l'étiquette correspondante.
-
Lorsque vous avez terminé l'examen de l'ensemble de données, cliquez sur l'onglet Entraînement situé sous la barre de titre.
La page d'entraînement présente une analyse de base de votre ensemble de données et vous indique si celui-ci est adapté à l'entraînement. Si AutoML Video suggère des modifications, vous pouvez revenir à la page Vidéos et ajouter des éléments ou des étiquettes.
- Lorsque l'ensemble de données est prêt, cliquez sur Démarrer l'entraînement pour créer un modèle ou sur Entraîner le nouveau modèle si vous souhaitez en créer un autre.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
- dataset-id : l'ID correspond au dernier élément du nom de l'ensemble de données.
Par exemple, si le nom de votre ensemble de données est
projects/434039606874/locations/us-central1/datasets/VCN3104518874390609379
, son ID estVCN3104518874390609379
. - Remarque :
- 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.
Méthode HTTP et URL :
POST https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
Corps JSON de la requête :
{ "displayName": "test_model", "dataset_id": "dataset-id", "videoClassificationModelMetadata": {} }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
et exécutez la commande suivante:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: project-number" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json
et exécutez la commande suivante:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-number" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models" | Select-Object -Expand Content
{ "name": "projects/project-number/locations/location-id/operations/operation-id", "metadata": { "@type": "type.googleapis.com/google.cloud.automl.v1beta1.OperationMetadata", "progressPercentage": 100, "createTime": "2020-02-27T01:56:28.395640Z", "updateTime": "2020-02-27T02:04:12.336070Z" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.automl.v1beta1.Model", "name": "projects/project-number/locations/location-id/models/operation-id", "createTime": "2020-02-27T02:00:22.329970Z", "videoClassificationModelMetadata": { "trainBudget": "1", "trainCost": "1", "stopReason": "BUDGET_REACHED" }, "displayName": "a_98487760535e48319dd204e6394670" } }
Java
Pour vous authentifier auprès d'AutoML Video, 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 d'AutoML Video, 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 d'AutoML Video, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Obtenir des informations sur un modèle
Une fois l'entraînement terminé, vous pouvez obtenir des informations sur le modèle que vous venez de créer.
Les exemples de cette section affichent les métadonnées de base relatives à un modèle. Pour en savoir plus sur la précision et l'état de préparation d'un modèle, consultez la page Évaluer les modèles.
UI Web
-
Accédez à la page Modèles dans l'interface utilisateur d'AutoML Video.
- Cliquez sur le nom du modèle que vous souhaitez afficher.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
- model-name : nom complet du modèle fourni par la réponse lors de la création du modèle. Il a le format suivant : projects/project-number/locations/location-id/models/model-id
- dataset-id : remplacez cette valeur par l'identifiant de votre ensemble de données, et non par le nom à afficher. Par exemple :
VCN3940649673949184000
- project-number : numéro de votre projet.
Méthode HTTP et URL :
GET https://automl.googleapis.com/v1beta1/model-name/modelEvaluations
Corps JSON de la requête :
{ "displayName": "test_model", "dataset_id": "dataset-id", "videoClassificationModelMetadata": {} }
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 d'AutoML Video, 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 d'AutoML Video, 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 d'AutoML Video, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Répertorier des modèles
Un projet peut inclure de nombreux modèles. Cette section décrit comment extraire la liste des modèles disponibles pour un projet.
UI Web
Accédez à la page Modèles de l'interface utilisateur d'AutoML Video pour afficher les modèles de votre projet.Pour afficher les modèles d'un autre projet, sélectionnez le projet dans la liste déroulante située dans la partie supérieure droite de la barre de titre.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
- model-name : nom complet du modèle fourni par la réponse lors de la création du modèle. Il a le format suivant : projects/project-number/locations/location-id/models
- Remarque :
- 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.
Méthode HTTP et URL :
GET https://automl.googleapis.com/v1beta1/projects/project-number/locations/location-id/models
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 d'AutoML Video, 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 d'AutoML Video, 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 d'AutoML Video, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Supprimer un modèle
L'exemple suivant supprime un modèle.
UI Web
- Accédez à la page Modèles dans l'interface utilisateur d'AutoML Video.
- Cliquez sur le menu à trois points à l'extrémité droite de la ligne à supprimer, puis sélectionnez Supprimer.
- Cliquez sur Supprimer dans la boîte de dialogue de confirmation.
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
- model-id : remplacez cette valeur par l'identifiant de votre modèle.
- Remarque :
- 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.
Méthode HTTP et URL :
DELETE https://automl.googleapis.com/v1beta1/projects/project-number/locations/test/models/model-id
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 d'AutoML Video, 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 d'AutoML Video, 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 d'AutoML Video, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.