Skip to main content
GET
Get dataset video characteristics

Authorizations

Authorization
string
header
required

Bearer access token issued through OAuth 2.0 client credentials.

Query Parameters

dataset
string
required

Dataset ID from GET /api/v1beta/quality/datasets.

analysis
string

Opaque analysis token from an earlier response. Omit to use the latest measurement.

video_characteristics
string

Opaque video_characteristics token from an earlier response. Omit to use the latest measurement.

blur_threshold
number<double>

Optional blur-score cutoff. When supplied, blur_score.above_threshold reports the percentage of observed frames strictly above it.

Required range: x >= 0
temporal_information_threshold
number<double>

Optional Temporal Information cutoff. When supplied, temporal_information.above_threshold reports the percentage of observed frame pairs strictly above it.

Required range: x >= 0

Response

Video-characteristic distributions, optional threshold results, and coverage

Dataset-level continuous frame measurements and measurement completeness.

analysis
string
required

Opaque token identifying the analysis used for this response.

blur_score
object
required

Edge-spread blur score distribution. Higher values mean more blur.

coverage_percent
number<double> | null
required

Percentage of the planned analysis that successfully produced values used in this response, in [0, 100]. This is measurement completeness, not the percentage of footage that passed quality control. null when the planned result count cannot be determined reliably. Non-null values are rounded to two decimal places.

Required range: 0 <= x <= 100
dataset
string
required

Dataset ID used in the request.

frames_measured
integer<int64>
required

Frames included in these summaries.

Required range: x >= 0
luma
object
required

Luminance distributions on an 8-bit 0-255 scale.

temporal_information
object
required

Temporal Information distribution. Higher values mean more consecutive-frame change, which can suggest jerkiness or instability but can also reflect fast valid motion.

video_characteristics
string
required

Opaque token identifying the video-characteristics measurement.