imagesVchitect/ShotBenchvision-languagebenchmarkcinematographyvideoevaluationvlmmultimodalqa

ShotBench Cinematic Understanding Benchmark

Free

Open dataset

Sample structure: 100 / 100
2 download links issued
Seller: DataBazaar
Sign up to download

Already have an account? Log in

Agent? Connect your account →

Category
Images
Records
3,572 rows
Format
PARQUET
Update Frequency
Not documented
Collection Method
uploaded
PII
No flagged field names; not a privacy audit
File Size
~0.12 MB
Download links issued
2

Source, license and coverage

Supplier documentation. These claims are separate from the automated sample score. A listing edit date is not a data freshness date.

License
apache-2.0
Source / creator
Vchitect/ShotBench
Collection method
The authors curated stills and clips from Oscar-nominated cinematography films to ensure high visual quality and strong cinematic style. Domain experts annotated each sample across cinematic dimensions (shot size, framing, camera angle, lens type, lighting type/condition, composition, camera movement), producing multiple-choice QA pairs. The set is intended as a held-out test benchmark rather than a training corpus.
Coverage start
Not documented
Coverage end
Not documented
Data last updated
Not documented
Update schedule
Not documented

Source documentation ↗

License terms ↗

The benchmark is English-only and skews toward award-nominated Western cinema, which may not represent global filmmaking traditions, TV, documentary, or amateur footage. With 3,572 items, statistical resolution between closely-matched models may be limited. As a public benchmark, leakage risk exists if used in training. Source does not exhaustively document annotator agreement; buyers should validate empirically.

Sample structure score: 100 / 100

This automated check describes the inspected sample, not factual accuracy, legal rights, representativeness, or the quality of the entire dataset. It is not a customer rating.

Assessed 10 sample records (JSON) on 2026-10-09. All records in the provided sample were checked.

CheckPointsEvidence
Populated cells50 / 5070 of 70 top-level cells contain a value. Null, absent and blank values count as missing; zero and false count as populated.
Consistent value types30 / 3070 of 70 populated cells match their column's most common observed type. Types are inferred, not checked against real-world truth.
Consistent record shape20 / 2010 of 10 records have the expected fields. CSV/TSV use the header width; JSON uses the union of observed keys.
Field-level findings and improvements

Check missing cells and mixed types below. Document intentional missing values or mixed types in your field descriptions. Do not fill legitimate unknowns with invented values just to increase this score.

FieldMissing cellsMost common typeOther populated types
index0 / 10number0 / 10
type0 / 10string0 / 10
path0 / 10string0 / 10
question0 / 10string0 / 10
options0 / 10string0 / 10
answer0 / 10string0 / 10
category0 / 10string0 / 10
How the score is calculated, its limitations, and how to correct an assessment →

About this data

Expert-level question-answer pairs evaluating cinematic understanding in vision-language models, drawn from Oscar-nominated cinematography films across images and video clips.

Retrieve with your agent or Python

Create an account and configure DATABAZAAR_API_KEY. This example retrieves free or already purchased data; it never makes a purchase. For a multi-file dataset, choose a file index from the manifest.

Download the Python example
python3 retrieve-dataset.py b1eb2f57-2782-4ad5-9a05-091512ee81db --output dataset.bin
Full supplier documentation
## Overview ShotBench is the official test set for evaluating expert-level cinematic understanding in vision-language models. It contains 3,572 question-answer pairs distributed across 3,049 images and 464 video clips, primarily sourced from films nominated for the Academy Award for Best Cinematography. Format is CSV with paired image/video media. Released by Vchitect in 2025. ## Schema - question — string — multiple-choice question about a cinematic dimension (shot size, framing, camera angle, lens, lighting, composition, movement) - options — string — answer choices - answer — string — ground-truth answer label - media_path — string — pointer to associated image or video clip - media_type — string — image or video - dimension/category — string — which cinematic skill is being probed - source_film — string — originating film reference (where provided) ## Sources - Vchitect/ShotBench on Hugging Face — https://huggingface.co/datasets/Vchitect/ShotBench — Apache-2.0 - Paper: ShotBench (arXiv:2506.21356) ## Methodology The authors curated stills and clips from Oscar-nominated cinematography films to ensure high visual quality and strong cinematic style. Domain experts annotated each sample across cinematic dimensions (shot size, framing, camera angle, lens type, lighting type/condition, composition, camera movement), producing multiple-choice QA pairs. The set is intended as a held-out test benchmark rather than a training corpus. ## Known gaps & limitations The benchmark is English-only and skews toward award-nominated Western cinema, which may not represent global filmmaking traditions, TV, documentary, or amateur footage. With 3,572 items, statistical resolution between closely-matched models may be limited. As a public benchmark, leakage risk exists if used in training. Source does not exhaustively document annotator agreement; buyers should validate empirically. ## Intended use & out-of-scope - Intended: evaluating vision-language and video-language models on cinematography understanding; comparative model benchmarking; probing VLM perception of camera/lens/lighting concepts. - Out-of-scope: training data for production models (leakage risk); general video understanding outside cinematic style; non-English deployment. Original supplier listing: ShotBench: Cinematic Understanding Benchmark for VLMs 3,572 expert-level QA pairs over 3,049 images and 464 video clips from Oscar-nominated cinematography films, for evaluating cinematic understanding in vision-language models.

Schema

NameTypeDescription
indexBIGINTUnique identifier for each question-answer pair (1–3,572).
typeVARCHARMedia format as JSON array; either ["image"] or ["video"].
pathVARCHARFile path(s) to media asset(s) as JSON array; format image/ID.jpg or video/ID.mp4.
questionVARCHARMultiple-choice question about cinematic technique applied to the media.
optionsVARCHARJSON object mapping letter keys (A–D) to answer choice strings.
answerVARCHARCorrect answer label as single letter (A, B, C, or D).
categoryVARCHARCinematic skill dimension: shot size, framing, camera angle, lens, lighting, composition, or movement.

Sample Data

Preview a sample of the data before downloading.

Public sample only. Sign in to retrieve the full dataset, including free datasets.

For AI Agents

Via MCP Server
# 1. Add to your agent's MCP config (claude_desktop_config.json or similar):
{
  "mcpServers": {
    "databazaar": { "command": "npx", "args": ["databazaar-mcp"] }
  }
}

# 2. Your agent can then call:
search_datasets({ query: "ShotBench Cinematic Understand" })
// Found: b1eb2f57-2782-4ad5-9a05-091512ee81db
get_download_url({ dataset_id: "b1eb2f57-2782-4ad5-9a05-091512ee81db" })  // free — sign in with MCP OAuth first
Via REST API
# Free dataset — sign in or use your account API key:
curl https://api.databazaar.io/datasets/b1eb2f57-2782-4ad5-9a05-091512ee81db/download-url -H "Authorization: Bearer $DATABAZAAR_API_KEY"