background - Judge API

Overview

Analyzes video backgrounds to evaluate whether specific elements are present or absent. The detector uses configurable criteria to check for desired elements that should be present and undesired elements that should not be present.

Configuration

config.desired_elements

array

List of elements that SHOULD be present in the background (e.g., “professional setting”, “clean workspace”, “natural lighting”)

config.undesired_elements

array

List of elements that should NOT be present in the background (e.g., “clutter”, “car interior”, “distracting objects”)

Example Configuration

{
  "detector_name": "background",
  "config": {
    "desired_elements": ["professional setting", "clean workspace", "good lighting"],
    "undesired_elements": ["clutter", "distracting objects", "inappropriate content"]
  }
}

Minimal Configuration

If no elements are specified, the detector will pass by default:

{
  "detector_name": "background",
  "config": {}
}

Result Schema

{
  "detector_name": "background",
  "pass_check": false,
  "score": 0.67,
  "rationale": "Background issues: Missing desired element: professional setting; Detected undesired element: clutter. Cluttered room with visible piles and unprofessional appearance.",
  "metrics": {
    "element_results": {
      "professional setting": false,
      "clean workspace": true,
      "good lighting": true,
      "clutter": true,
      "distracting objects": false
    },
    "missing_desired": ["professional setting"],
    "detected_undesired": ["clutter"],
    "reasons": "Cluttered room with visible piles and unprofessional appearance",
    "desired_elements": ["professional setting", "clean workspace", "good lighting"],
    "undesired_elements": ["clutter", "distracting objects"]
  },
  "timestamps": [1.2, 3.6, 4.8]
}

​Overview

​Configuration

​Example Configuration

​Minimal Configuration

​Result Schema

Overview

Configuration

Example Configuration

Minimal Configuration

Result Schema