Envoyer une vidéo

Ce guide couvre toutes les manières d’envoyer une vidéo à Gaard Classify : le téléversement manuel dans l’application web, l’API de classification pour les pipelines automatisés, et la re-classification d’une vidéo déjà stockée.

Choisir un mode d’envoi

Méthode	Idéal pour	Prise en charge des métadonnées
Téléversement dans l’application web	Vérifications ponctuelles, tests, quelques clips	Non : utilisez l’API pour joindre des métadonnées
API de classification	Intégrations caméra, pipelines par lots, tout traitement automatisé	Oui : `metadata.json`
Re-classification	Relancer une vidéo stockée après un changement de configuration	Hérite de l’envoi d’origine

Téléverser depuis l’application web

Le téléversement se déroule en trois étapes : sélectionner les fichiers, téléverser, terminé. Il accepte plusieurs fichiers à la fois et affiche la progression fichier par fichier.

Ouvrez la vue Upload dans l’application web.
Glissez-déposez des fichiers vidéo sur la zone de dépôt, ou sélectionnez Ouvrir le sélecteur de fichiers et choisissez-les sur votre machine. Chaque fichier sélectionné apparaît dans une liste avec son nom et sa taille.
Sélectionnez Télécharger et classer. La progression s’affiche en pourcentage à côté de chaque fichier.
Lorsque tous les fichiers atteignent 100 %, le message Tous les fichiers vidéo ont été envoyés au classement ! apparaît. Sélectionnez Télécharger à nouveau pour en envoyer d’autres, ou ouvrez l’espace de revue pour traiter les résultats.

Envoyer via l’API

Les intégrations automatisées envoient la vidéo à POST /api/classify sous forme de requête multipart/form-data. La vidéo est envoyée dans un champ de formulaire nommé video : et non dans un corps JSON.

curl -X POST https://vision.gaard.ai/api/classify \
  -H "Authorization: Bearer $API_KEY" \
  -F "[email protected]"

La référence complète de l’endpoint (chaque paramètre, la forme de la réponse et les endpoints associés) se trouve dans Endpoints. Un jeton d’API est nécessaire pour s’authentifier ; voir Jetons d’API.

Synchrone ou asynchrone

Le paramètre de requête sync détermine si la requête attend le résultat.

Mode	Requête	Réponse	À utiliser quand
Asynchrone (par défaut)	`POST /api/classify`	Un `id` et un horodatage `accepted_at` : récupérez le résultat plus tard, ou recevez-le par webhook	Le débit est prioritaire et vous traitez les résultats à part
Synchrone	`POST /api/classify?sync=true`	Le résultat de classification complet dans le corps de la réponse	Vous avez besoin du verdict en ligne, en un seul appel

La réponse asynchrone est renvoyée immédiatement :

{
  "id": "66436fc66d24ab9cf81140eb",
  "accepted_at": "2024-05-14T16:05:58.444Z"
}

L’id est le classify_id utilisé par tous les autres endpoints : récupérez le résultat avec GET /api/result/<classify_id>.

Joindre des métadonnées

Un fichier metadata.json permet d’associer un envoi au site et à la caméra dont il provient, afin que les résultats soient attribuables dans l’espace de revue et filtrables par site et par caméra. Tous les champs sont optionnels.

{
  "site_id": "134188",
  "camera_id": "VI01"
}

Envoyez-le dans un second champ de formulaire nommé metadata :

curl -X POST https://vision.gaard.ai/api/classify \
  -H "Authorization: Bearer $API_KEY" \
  -F "[email protected]" \
  -F "[email protected]"

La liste complète des champs et leur comportement de repli sont documentés dans Métadonnées.

Re-classifier une vidéo stockée

Lorsque vous modifiez un seuil ou ajoutez une zone d’exclusion, vous voulez souvent voir comment un résultat existant évoluerait : sans re-téléverser le fichier. La re-classification relance la vidéo stockée dans la classification.

Dans l’espace de revue, ouvrez une classification pour afficher sa vue détaillée.
Sélectionnez Reclassify. Le bouton devient Sent pendant le re-traitement de la vidéo, puis la vue se rafraîchit avec le nouveau résultat.

La re-classification réutilise la vidéo et les métadonnées d’origine, de sorte que le nouveau résultat est directement comparable à l’ancien.

Étapes suivantes

Examiner les classifications Traitez les résultats dans l'espace de revue.

Choisir une méthode de livraison Polling, webhooks ou SFTP pour les résultats asynchrones.

Métadonnées La référence complète des champs metadata.json.