1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-11 15:39:42 +00:00
gcloud-help/gcloud/beta/ml/translate/translate-text
2022-03-01 04:29:52 +00:00

97 lines
3.3 KiB
Text

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