mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 15:39:42 +00:00
100 lines
3.5 KiB
Text
100 lines
3.5 KiB
Text
NAME
|
|
gcloud alpha ml translate translate-text - use the Google Cloud Translation
|
|
API to translate between languages
|
|
|
|
SYNOPSIS
|
|
gcloud alpha 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
|
|
(ALPHA) Translates input text and returns translated text.
|
|
|
|
EXAMPLES
|
|
The following command translates 'What beautiful weather!' into French.
|
|
|
|
$ gcloud alpha 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/v3beta1 API. The full documentation for
|
|
this API can be found at:
|
|
https://cloud.google.com/translate/docs/quickstarts
|
|
|
|
NOTES
|
|
This command is currently in alpha and might change without notice. If this
|
|
command fails with API permission errors despite specifying the correct
|
|
project, you might be trying to access an API with an invitation-only early
|
|
access allowlist. This variant is also available:
|
|
|
|
$ gcloud beta ml translate translate-text
|
|
|