logo - Judge API

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.

​Overview

​Configuration

​Example Configuration

​Result Schema

​Interpreting Results

Overview

Configuration

Example Configuration

Result Schema

Interpreting Results