O Cloud Translation - Advanced é compatível com a tradução de textos usando os modelos personalizados e com a criação de glossários para garantir que a API Cloud Translation forneça a tradução correta da terminologia específica do domínio do cliente.
Para instruções sobre como instalar a CLI do Google Cloud, configurar um projeto com uma conta de serviço e receber um token de acesso, consulte a página Configuração. Se você planeja usar um glossário ou os recursos em lote, também precisa criar um bucket do Cloud Storage e conceder acesso à sua conta de serviço.
Para traduzir documentos formatados, como PDFs, consulte Traduzir documentos.
Antes de começar
Antes de começar a usar a API Cloud Translation, é preciso ter um projeto com a API Cloud Translation ativada e as credenciais apropriadas. Também é possível instalar bibliotecas de cliente para linguagens de programação comuns para ajudar você a fazer chamadas para a API. Para ver mais informações, consulte a página Configuração.
Como comparar modelos
Ao solicitar a tradução do Cloud Translation - Advanced, é possível especificar qual modelo de tradução usar. Se nenhum modelo for especificado, nmt
será usado.
Modelo | Tamanho original | Exemplos |
---|---|---|
Modelo de tradução automática neural (NMT, na sigla em inglês) |
Casos gerais de uso de texto, como conteúdo de sites comuns que não são específicos de um domínio, por exemplo, novos artigos. |
Notícias, mídia social, aplicativos de chat, comentários |
Modelo de tradução de linguagem grande (LLM) (pré-lançamento) |
Há um modelo alternativo para isso no Cloud Translation - Advanced em dois modos. Tradução de texto para casos de uso gerais de texto, como mensagens de conversa, que não exigem personalização. E tradução adaptativa, que permite a personalização em tempo real usando um conjunto de dados de exemplo. |
Notícias, mídia social, aplicativos de chat, comentários |
Modelo do AutoML Translation | Texto específico do domínio. Os clientes fornecem dados de treinamento específicos para os casos de uso deles, para que determinados pares de idiomas personalizem o modelo NMT do Google para fins de domínio. | Notícias financeiras, documentos técnicos, qualquer texto que use termos e jargões exclusivos desse campo. |
Especifique o modelo de tradução usando o ID de modelo. Os IDs do modelo NMT e LLM são general/nmt
e general/translation-llm
.
Os IDs de modelo do AutoML Translation são gerados após o treinamento.
Considerações
Cada modelo oferece suporte aos próprios idiomas definidos. Verifique se os idiomas de origem e de destino são compatíveis. Para mais informações, consulte Idiomas compatíveis.
Não há suporte para glossários nas traduções de texto de LLM. Considere usar a tradução adaptativa se preferir personalizar traduções.
Para traduções de texto em LLM, o tipo MIME precisa ser
text/plain
. HTML não é compatível.
Como traduzir textos
Para os modelos NMT e AutoML Translation, o texto de entrada pode ser texto simples ou HTML. A API Cloud Translation não traduz nenhuma tag HTML na entrada, apenas o texto que aparece entre as tags. A saída mantém as tags HTML (não traduzidas), com o texto traduzido entre elas na medida do possível devido a diferenças entre os idiomas de origem e de destino. A ordem das tags HTML na saída pode ser diferente da ordem no texto de entrada por causa de alterações na ordem das palavras na tradução.
Para traduções de texto LLM (Prévia), o tipo MIME precisa ser
text/plain
.
Como traduzir strings de entrada
REST
Para traduzir um texto, faça uma solicitação POST
e forneça, no corpo dela, o
JSON que identifica o idioma de origem (source_language_code
), o
idioma de destino (target_language_code
) e o texto a ser traduzido
(contents
). Para traduzir várias strings de texto, basta incluí-las
no JSON (veja o exemplo). Use os códigos ISO-639 para
identificar os idiomas de origem e de
destino.
Veja a seguir um exemplo de uma solicitação POST
usando curl
ou PowerShell. O exemplo usa o token de acesso de uma conta de serviço configurada para o projeto por meio da Google Cloud CLI.
Consulte a página Configuração
para ver instruções de como instalar a CLI do Google Cloud, configurar um projeto com uma conta de serviço
e conseguir um token de acesso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do projeto do Google Cloud
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corpo JSON da solicitação:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
A matriz translations
contém dois campos translatedText
com traduções
fornecidas no idioma targetLanguageCode
solicitado (ru
: russo). As traduções são listadas na mesma ordem da matriz de origem correspondente na solicitação.
Go
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Go.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Java.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Node.js.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Python.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
C#: Siga as Instruções de configuração do C# na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para o .NET.
PHP: Siga as Instruções de configuração do PHP na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para PHP.
Ruby: Siga as Instruções de configuração do Ruby na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para Ruby.
Como traduzir textos usando um modelo específico
REST
Para especificar qual modelo será usado para a tradução, use o
parâmetro de
consulta model
.
O exemplo a seguir traduz texto usando um modelo personalizado com um ID de modelo 1395675701985363739
. É possível conseguir o ID para um modelo personalizado na lista
de modelos no Console do Google Cloud ou na resposta da API ao treinar
o modelo.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID pelo ID do projeto no Google Cloud.
- LOCATION: a região onde o modelo personalizado está localizado, como
us-central1
.
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Corpo JSON da solicitação:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Go.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Java.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Node.js.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Python.
Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Outras linguagens
C#: Siga as Instruções de configuração do C# na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para o .NET.
PHP: Siga as Instruções de configuração do PHP na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para PHP.
Ruby: Siga as Instruções de configuração do Ruby na página das bibliotecas de cliente e acesse Documentação de referência do Cloud Translation para Ruby.
Transliteração
A transliteração é uma definição de configuração no método translateText
. Ao
ativar a transliteração, você traduz o texto romanizado (script latino) diretamente
para um idioma de destino. Por exemplo, é possível traduzir textos em japonês romanizados
diretamente para inglês, espanhol ou chinês. As traduções resultantes ficam no
sistema de escrita do idioma de destino.
Nas solicitações de transliteração, inclua somente texto romanizado. Se você misturar texto romanizado com texto não romanizado, o Cloud Translation não poderá garantir traduções consistentes e adequadas.
Considerações
A transliteração difere das traduções de texto padrão das seguintes maneiras:
- A transliteração é compatível com um número limitado de idiomas. Para mais informações, consulte a coluna Transliteração na página Idiomas compatíveis.
- O tipo MIME precisa ser
text/plain
. HTML não é compatível. - A transliteração é compatível apenas com o modelo padrão padrão. Modelos personalizados não são compatíveis.
- A transliteração tem uma cota de conteúdo padrão mais baixa. Para mais informações, consulte Cotas e limites.
REST
Defina o campo transliteration_config
no
método
translateText
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do seu projeto do Google Cloud.
- LOCATION: região em que você quer executar a operação. Por
exemplo,
us-central1
. - SOURCE_LANGUAGE: (opcional) o código do idioma do texto de entrada. Se possível, defina um dos códigos de idioma listados em Suporte a idiomas.
- TARGET_LANGUAGE: o idioma de chegada para o qual traduzir o texto de entrada. Defina como um dos códigos de idioma listados em Suporte a idiomas.
- SOURCE_TEXT: texto romanizado no idioma de origem para traduzir.
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Corpo JSON da solicitação:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Outros recursos
- Para receber ajuda sobre como resolver erros ou problemas comuns, consulte a página Solução de problemas.