gcloud alpha ml video detect-labels

NAME
gcloud alpha ml video detect-labels - detect general labels for videos
SYNOPSIS
gcloud alpha ml video detect-labelsINPUT_PATH[--async][--detection-mode=DETECTION_MODE; default="shot"][--output-uri=OUTPUT_URI][--region=REGION][--segments=[SEGMENTS,…]][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Detect general categories in videos, such as modes oftransportation or animals. Use the --detection-mode flag to control whetherlabels are detected for shots, frames, or both.
EXAMPLES
To detect labels in video file 'gs://my_bucket/input_file.mp4':
gcloudalphamlvideodetect-labelsgs://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 StorageURI.
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 StorageURI.
--region=REGION
Optional Cloud region where annotation should take place. If no region isspecified, a region will be determined based on video file location.REGION must 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 videowill be treated as one segment). Must be in the formatSTART1:END1[,START2:END2,…] (inclusive). START and END of segments mustbe a properly formatted duration string of the formHhMmSs where:
*Histhenumberofhoursfrombeginningofvideo*Misthenumberofminutesfromthebeginningofvideo*Sisthenumberofsecondsfromthebeginningofthevideo

H, M and S can be specified as ints or floats for fractional units (tomicrosecond resolution). Unit chars (e.g.h,m ors) are required. Microseconds can be specified using fractionalseconds 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 help for details.

API REFERENCE
This command uses thevideointelligence/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/video-intelligence/docs/
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudmlvideodetect-labels
gcloudbetamlvideodetect-labels

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-22 UTC.