API des labels

Les labels permettent de fournir un retour sur les résultats de classification : en les marquant comme vrais positifs, faux positifs, ou en appliquant des labels personnalisés pour votre propre suivi.

Lister tous les labels

OPTIONS /api/label

Renvoie les labels standard et personnalisés disponibles pour le tenant courant.

Exemple de réponse

{
  "standard": [
    "animal", "flag", "person", "plant", "rain",
    "spider", "text", "vehicle", "web", "wind",
    "EMPTY", "FIX", "N/A"
  ],
  "custom": ["mon-label-personnalise"]
}

Champ	Type	Description
standard	string[]	Labels intégrés fournis par Gaard.
custom	string[]	Labels personnalisés créés par votre équipe.

Note

Cet endpoint utilise la méthode HTTP OPTIONS. Certains clients HTTP utilisent GET par défaut : assurez-vous que le vôtre prend en charge les requêtes OPTIONS.

Publier un label

POST /api/label/<classify_id>

Attache un ou plusieurs labels et un commentaire optionnel à un résultat de classification existant.

Corps de la requête

{
  "labels": ["FP"],
  "comment": "Fausse alerte - vent agitant une branche"
}

Champ	Type	Requis	Description
labels	string[]	Oui	Un ou plusieurs labels à attacher.
comment	string	Non	Commentaire libre expliquant le label.

Labels recommandés

Label	Signification
FP	Faux positif : Gaard a signalé la vidéo mais il n’y avait pas de menace réelle.
TP	Vrai positif : Gaard a correctement identifié une menace.
FN	Faux négatif : Gaard a manqué une menace réelle.
TN	Vrai négatif : Gaard a correctement classifié la vidéo comme sûre.

Vous pouvez également utiliser des labels plus simples : true ou false.

Les labels personnalisés sont acceptés : toute valeur texte que vous fournissez sera enregistrée et apparaîtra dans la liste renvoyée par OPTIONS /api/label.