Skip to main content

​
Overview

Verifies that a reference logo image appears in a video. Useful for ensuring brand logos, watermarks, or required visual marks are present throughout content.

​
Configuration

​
config.reference_image
string
required
Reference image of the logo to detect in the video.Allowed extensions: png, jpg, jpeg, webp
​
config.always_present
boolean
default:false
When true, the detector requires the logo to be present throughout the video. When false, the detector passes if the logo is found at any point.

​
Example Configuration

{
  "detector_name": "logo",
  "config": {
    "reference_image": "gs://judge-artifacts/org_123/reference_uploads/abc/brand_logo.png",
    "always_present": true
  }
}

​
Result Schema

{
  "detector_name": "logo",
  "pass_check": false,
  "score": 0.85,
  "rationale": "Logo detected in 85% of video. always_present requires logo in every frame.",
  "metrics": {
    "logo_presence_pct": 0.85,
    "always_present": true
  },
  "timestamps": [12.0, 24.0, 36.0]
}

​
Interpreting Results

  • score: How much of the video contains the logo (0.0 to 1.0).
  • logo_presence_pct: Percentage of the video where the logo was detected.
  • timestamps: Timestamps (in seconds) where the logo was not detected. Use these to identify gaps in logo coverage.
  • pass_check: When always_present is true, passes only if the logo is found throughout the entire video. When false, passes if the logo is found at any point.