- NAME
-
- gcloud beta ml video detect-labels - detect general labels for videos
- SYNOPSIS
-
-
gcloud beta ml video detect-labelsINPUT_PATH[--async] [--detection-mode=DETECTION_MODE; default="shot"] [--output-uri=OUTPUT_URI] [--region=REGION] [--segments=[SEGMENTS, …]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Detect general categories in videos, such as modes of transportation or animals. Use the --detection-mode flag to control whether labels are detected for shots, frames, or both. - EXAMPLES
- To detect labels in video file 'gs://my_bucket/input_file.mp4':
gcloud beta ml video detect-labels gs://my_bucket/input_file.mp4 - POSITIONAL ARGUMENTS
-
-
INPUT_PATH - Path to the video to be analyzed. Must be a local path or a Google Cloud Storage URI.
-
- FLAGS
-
-
--async - Return immediately, without waiting for the operation in progress to complete.
-
--detection-mode=DETECTION_MODE; default="shot" - The mode of label detection requested.
DETECTION_MODEmust be one of:-
frame - Detect labels at the per-frame level.
-
shot - Detect labels at the per-shot level.
-
shot-and-frame - Detect labels at both the per-shot and per-frame level.
-
-
--output-uri=OUTPUT_URI - Location to which the results should be written. Must be a Google Cloud Storage URI.
-
--region=REGION - Optional Cloud region where annotation should take place. If no region is
specified, a region will be determined based on video file location.
REGIONmust be one of:asia-east1,europe-west1,us-east1,us-west1. -
--segments=[SEGMENTS,…] - Segments from the video which you want to analyze (by default, the entire video
will be treated as one segment). Must be in the format
START1:END1[,START2:END2,…] (inclusive). START and END of segments must
be a properly formatted duration string of the form
HhMmSswhere:* H is the number of hours from beginning of video * M is the number of minutes from the beginning of video * S is the number of seconds from the beginning of the video
H, M and S can be specified as ints or floats for fractional units (to microsecond resolution). Unit chars (e.g.
h,mors) are required. Microseconds can be specified using fractional seconds e.g. 0.000569s == 569 microseconds.Examples:
0s:23.554048s,24s:29.528064s
0:1m40s,3m50s:5m10.232265s
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - API REFERENCE
- This command uses the
videointelligence/v1API. The full documentation for this API can be found at: https://cloud.google.com/video-intelligence/docs/ - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud ml video detect-labelsgcloud alpha ml video detect-labels
gcloud beta ml video detect-labels
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

