NAME

gcloud beta ml translate translate-text - use the Google Cloud Translation API to translate between languages

SYNOPSIS

gcloud beta ml translate translate-text --target-language=TARGET_LANGUAGE (--content=CONTENT | --content-file=CONTENT_FILE) [--glossary-config=GLOSSARY_CONFIG] [--mime-type=MIME_TYPE] [--model=MODEL] [--source-language=SOURCE_LANGUAGE] [--zone=ZONE; default="global"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) Translates input text and returns translated text.

EXAMPLES

The following command translates 'What beautiful weather!' into French.

$ gcloud beta ml translate translate-text \ --content='What beautiful weather!' --zone=us-central1 \ --target-language=fr-CA

REQUIRED FLAGS

--target-language=TARGET_LANGUAGE

The BCP-47 language code to use for translation of the input text.

Contents group.

Exactly one of these must be specified:

--content=CONTENT

The content of the input in string format. We recommend that the content be less than 30k codepoints.

--content-file=CONTENT_FILE

Specify a local file path containing the text to be translated.

OPTIONAL FLAGS

--glossary-config=GLOSSARY_CONFIG

Glossary to be applied. The glossary must be within the same region as the model.

--mime-type=MIME_TYPE

The format of the source text, for example, 'text/html', 'text/plain'. Defaults to 'text/html'.

--model=MODEL

The model type requested for this translation. The format depends on the model type:

for AutoML Translation models: model-id

for General (built-in) models: general/nmt or general/base

Authorization requires one or more of the following Google IAM permissions on the specified resource model:

cloudtranslate.generalModels.predict

automl.models.predict

If missing, the system decides which google base model to use.

Usage:

AutoML models: '--model=TRL321456789'

General models: '--model=general/nmt'

--source-language=SOURCE_LANGUAGE

The BCP-47 language code of the input text if known, for example, 'en-US' or 'sr-Latn'. If the source language isn't specified, the API attempts to identify the source language automatically and returns the source language in the response.

--zone=ZONE; default="global"

Location to make calls. Non-global location is required for requests using AutoML models. Currently, only 'us-central1' is supported as a non-global location. Defaults to 'global'.

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

NOTES

This command is currently in beta and might change without notice. This variant is also available:

$ gcloud alpha ml translate translate-text