Référence API

API de modération Vigie

Une API REST simple : envoyez une image, recevez une décision APPROVE / REVIEW / BLOCK avec scores, attributs et latence. Tout est traité localement — aucune image ne quitte votre infrastructure.

Swagger interactif (OpenAPI) →

URL de base & authentification

Tous les endpoints sont relatifs à l'hôte où Vigie est déployé. Aucune clé API n'est requise par défaut — le service est conçu pour tourner dans votre périmètre réseau privé.

# base URL
https://vigie.gfsolutions.ca
Exposé sur un réseau public ? Placez Vigie derrière votre passerelle (mTLS, clé API, IP allowlist). L'auth réseau est volontairement laissée à votre infrastructure.

Logique de décision

Chaque requête retourne un verdict unique. Les filtres reject_* forcent un BLOCK ; les filtres review_* forcent un REVIEW ; sinon la décision suit le score NSFW et le VLM.

APPROVE

Contenu sûr. Aucun seuil de blocage atteint.

REVIEW

Ambigu ou seuil review_* atteint — à faire valider par un humain.

BLOCK

NSFW explicite ou seuil reject_* atteint. À rejeter.

Filtres & seuils

Activez block_content_filters: true, puis fournissez des seuils en pourcentage par attribut. Sur /moderate/url via l'objet content_filter_thresholds ; sur /moderate/photo via des champs content_filter_threshold_<nom>. Un seuil de 0 ignore le filtre.

# /moderate/url — bloquer flou ≥70% et texte offensant ≥50%
{
  "url": "https://exemple.com/photo.jpg",
  "always_use_vlm": true,
  "block_content_filters": true,
  "content_filter_thresholds": {
    "blurry": 70,
    "reject_offensive_text": 50,
    "review_multiple_people": 60
  }
}

Taxonomie

Catégories NSFW / contexte retournées dans category :

safe_low_risklikely_safeswimwear_non_sexualunderwear_non_sexualambiguous_nudityexplicit_nudityvisible_genitalsmedical_contextart_contextmeme_or_screenshotunclear_imagemodel_uncertain

Attributs & filtres disponibles (scores 0–1 dans photo_quality, quality_filters, content_attributes, content_filters) :

sharpnessexposurelightingresolution_qualitycompositionblurrytoo_darktoo_brightlow_resolutionheavy_filter_or_editobstructed_subjectscreenshot_or_memeperson_presentface_visiblemultiple_peopleindoor_roombedroommessy_roomcluttertext_presentoffensive_text_presentprofanity_text_presenthate_speech_text_presentthreat_or_harassment_text_presentlogo_presentwatermark_presentdirty_environmentclean_background

Erreurs

CodeDescription