NAME

gcloud ml video detect-labels - detect general labels for videos

SYNOPSIS

gcloud ml video detect-labels INPUT_PATH [--async] [--detection-mode=DETECTION_MODE; default="shot"] [--output-uri=OUTPUT_URI] [--region=REGION] [--segments=[SEGMENTS,...]] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

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 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_MODE must 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. 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 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 HhMmSs where:

* 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, m or s) 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 help for details.

API REFERENCE

This command uses the videointelligence/v1 API. The full documentation for this API can be found at: https://cloud.google.com/video-intelligence/docs/

NOTES

These variants are also available:

$ gcloud alpha ml video detect-labels

$ gcloud beta ml video detect-labels