NAME

gcloud beta ml vision detect-faces - detect faces within an image

SYNOPSIS

gcloud beta ml vision detect-faces IMAGE_PATH [--max-results=MAX_RESULTS] [--model-version=MODEL_VERSION; default="builtin/stable"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) Detect faces within an image.

EXAMPLES

To detect faces in image 'gs://my_bucket/input_file':

$ gcloud beta ml vision detect-faces gs://my_bucket/input_file

POSITIONAL ARGUMENTS

IMAGE_PATH

Path to the image to be analyzed. This can be either a local path or a URL. If you provide a local file, the contents will be sent directly to Google Cloud Vision. If you provide a URL, it must be in Google Cloud Storage format (gs://bucket/object) or an HTTP URL (http://... or https://...)

FLAGS

--max-results=MAX_RESULTS

Maximum number of results to be provided.

--model-version=MODEL_VERSION; default="builtin/stable"

Model version to use for the feature. MODEL_VERSION must be one of: builtin/latest, builtin/stable.

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 vision/v1 API. The full documentation for this API can be found at: https://cloud.google.com/vision/

NOTES

This command is currently in beta and might change without notice. These variants are also available:

$ gcloud ml vision detect-faces

$ gcloud alpha ml vision detect-faces