O Cloud Translation – Advanced está otimizado para a personalização e exemplos de utilização de conteúdo de formato longo. Além do modelo de tradução automática neural (NMT), o Advanced dá-lhe acesso ao GML de tradução (o modelo de tradução de estilo GML de mais alta qualidade mais recente da Google) e à capacidade de criar modelos personalizados.
O Cloud Translation – Advanced também oferece capacidades de tradução de texto avançadas, como traduzir documentos e criar glossários, para garantir que a terminologia específica do seu domínio é traduzida corretamente.
Antes de começar
Antes de poder começar a usar a API Cloud Translation, tem de ter um projeto com a API Cloud Translation ativada e as credenciais adequadas. Também pode instalar bibliotecas cliente para linguagens de programação comuns para ajudar a fazer chamadas para a API. Para mais informações, consulte a página Configuração.
Para ver instruções sobre como instalar a CLI Google Cloud, configurar um projeto com uma conta de serviço e obter um token de acesso, consulte a página de configuração. Se planeia usar um glossário ou as funcionalidades de processamento em lote, também tem de criar um contentor do Cloud Storage e conceder à sua conta de serviço acesso ao mesmo.
Traduz o texto
Para traduções, a entrada pode ser texto simples ou HTML. A API Cloud Translation não traduz quaisquer etiquetas HTML na entrada, apenas o texto que aparece entre as etiquetas. A saída retém as etiquetas HTML (não traduzidas), com o texto traduzido entre as etiquetas, na medida do possível, devido a diferenças entre os idiomas de origem e de destino.
Traduza strings de entrada
REST
Para traduzir texto, faça um pedido POST
e forneça JSON no corpo do pedido
que identifique o idioma a partir do qual traduzir (source_language_code
), o
idioma para o qual traduzir (target_language_code
) e o texto a traduzir
(contents
). Pode fornecer várias strings de texto para traduzir, incluindo-as
no seu JSON (consulte o exemplo). Identifica os idiomas de origem e destino
através dos respetivos códigos ISO-639.
O exemplo seguinte mostra um pedido POST
usando o
curl
ou o PowerShell. O exemplo usa o token de acesso para uma conta de serviço configurada para o projeto através da Google Cloud
CLI do Google Cloud.
Para obter instruções sobre a instalação da CLI Google Cloud,
a configuração de um projeto com uma conta de serviço e a obtenção de um token de acesso,
consulte a página de configuração.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do seu Google Cloud projeto
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corpo JSON do pedido:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
A matriz translations
contém dois campos translatedText
com traduções
disponibilizadas no idioma targetLanguageCode
pedido (ru
: russo). As traduções são apresentadas na mesma ordem que a matriz de origem correspondente no pedido.
Go
Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da GoAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da JavaAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da Node.jsAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da PythonAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Idiomas adicionais
C#: Siga as instruções de configuração do C# na página das bibliotecas de cliente e, em seguida, visite a documentação de referência do Cloud Translation para .NET.
PHP: Siga as instruções de configuração do PHP na página das bibliotecas cliente e, em seguida, visite a 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 cliente e, em seguida, visite a documentação de referência do Cloud Translation para Ruby.
Traduza texto com um modelo específico
REST
Pode especificar o modelo a usar para a tradução através do parâmetro de consulta
model
.
O exemplo seguinte traduz texto através de um modelo personalizado com um ID do modelo de
1395675701985363739
. Pode obter o ID do modelo de um modelo personalizado na lista de modelos na consola, na resposta da API ou na página do Pantheon correspondente quando treina o modelo. Google Cloud Para usar o LLM de tradução, especifique general/translation-llm
como o ID do modelo. Para usar o GML de tradução personalizado (pré-visualização pública), especifique model/translation-llm-custom/{model-id}
como o ID do modelo.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- PROJECT_ID: o ID do seu Google Cloud projeto.
- 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 do pedido:
{ "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 o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte comando:
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
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte comando:
$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
Deve receber uma resposta JSON semelhante à seguinte:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Antes de experimentar este exemplo, siga as Goinstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da GoAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Java
Antes de experimentar este exemplo, siga as Javainstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da JavaAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de experimentar este exemplo, siga as Node.jsinstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da Node.jsAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Python
Antes de experimentar este exemplo, siga as Pythoninstruções de configuração no início rápido do Cloud Translation com bibliotecas cliente. Para mais informações, consulte a documentação de referência da PythonAPI Cloud Translation.
Para se autenticar no Cloud Translation, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para um ambiente de desenvolvimento local.
Idiomas adicionais
C#: Siga as instruções de configuração do C# na página das bibliotecas de cliente e, em seguida, visite a documentação de referência do Cloud Translation para .NET.
PHP: Siga as instruções de configuração do PHP na página das bibliotecas cliente e, em seguida, visite a 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 cliente e, em seguida, visite a 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
. Quando ativa a transliteração, traduz texto romanizado (escrita latina) diretamente para um idioma de destino. Por exemplo, pode traduzir texto japonês romanizado diretamente para inglês, espanhol ou chinês. As traduções resultantes estão no sistema de escrita do idioma de destino.
Nas suas solicitações de transliteração, inclua apenas texto romanizado. Se misturar texto romanizado com texto não romanizado, o Cloud Translation não pode garantir traduções consistentes e adequadas.
Considerações
A transliteração difere das traduções de texto padrão nos seguintes aspetos:
- 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 tem de ser
text/plain
. O HTML não é suportado. - A transliteração só é suportada pelo modelo padrão predefinido. Os modelos personalizados não são suportados.
- A transliteração tem uma quota de conteúdo predefinida inferior. Para mais informações, consulte o artigo Quotas e limites.
REST
Defina o campo transliteration_config
no método translateText
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do seu projeto Google Cloud .
- LOCATION: região onde quer executar esta operação. Por
exemplo,
us-central1
. - SOURCE_LANGUAGE: (Opcional) O código do idioma do texto de entrada. Se souber, defina um dos códigos de idioma indicados em Suporte de idiomas.
- TARGET_LANGUAGE: o idioma de destino para o qual o texto de entrada deve ser traduzido. Definido para um dos códigos de idioma indicados em Suporte de idiomas.
- SOURCE_TEXT: texto romanizado no idioma de origem a traduzir.
Método HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Corpo JSON do pedido:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Para enviar o seu pedido, expanda uma destas opções:
Deve receber uma resposta JSON semelhante à seguinte:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Recursos adicionais
- Para obter ajuda na resolução de problemas ou erros comuns, consulte a página de resolução de problemas.