- 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 helpfor details. - API REFERENCE
- This command uses the
translate/v3API. 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
gcloud beta ml translate translate-text
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.

