Vista geral da Cloud Translation API

A Cloud Translation API pode traduzir texto para mais de 100 pares de idiomas. Se não souber o idioma do texto de origem, a Cloud Translation API pode detetá-lo por si. Para ver uma lista de todos os idiomas suportados, consulte o artigo Idiomas suportados.

Como organização empresarial, pode incluir texto traduzido nos fluxos de trabalho internos existentes. Por exemplo, pode ter uma equipa de apoio técnico global que recebe registos de clientes em vários idiomas diferentes. Pode adicionar a Cloud Translation API ao seu fluxo de trabalho para traduzir esses registos de clientes para o idioma falado pelos membros da sua equipa de apoio técnico. Ao usar a API Cloud Translation, melhora a eficiência geral da sua equipa de apoio técnico, uma vez que não precisa de traduzir manualmente o texto nem depender de outras pessoas.

A Cloud Translation API é dimensionada de forma integrada e permite traduções de carateres ilimitadas por dia. No entanto, existem restrições no tamanho do conteúdo para cada pedido e taxas de pedidos. Além disso, pode usar limites de quota para gerir o seu orçamento. Para mais informações, consulte Quotas e limites.

A API Cloud Translation está disponível em duas edições diferentes, nomeadamente a edição Basic e a edição Advanced. Para ver uma lista das diferentes funcionalidades suportadas por cada um, consulte a comparação de edições.

Cloud Translation - Basic API

A edição Basic é acedida através das bibliotecas de cliente v2 e requer uma configuração mínima. Aceita chaves da API para autenticação, bem como contas de serviço, e usa o modelo de tradução automática neural (NMT) pré-preparado da Google sem modificações. É adequado para aplicações que precisam de traduzir conteúdo gerado pelo utilizador casual, como conversas, redes sociais ou comentários.

Por predefinição, a API Cloud Translation usa a edição Basic, que a Google atualiza com uma cadência semirregular à medida que são disponibilizados mais dados de preparação e melhores técnicas.

No entanto, se estiver a planear um novo projeto, recomendamos que escolha a edição Advanced para tirar partido de uma melhor segurança, mais funcionalidades e das novas melhorias do serviço que a edição Advanced vai continuar a implementar no futuro.

API Cloud Translation – Advanced

A edição avançada é acedida através das bibliotecas de cliente v3 e requer a autenticação da conta de serviço integrada com as funções do IAM. Oferece uma escolha de modelos, incluindo o modelo LLM de tradução, o modelo NMT e as personalizações de NMT. Também oferece funcionalidades como glossários, tradução em lote, tradução de documentos e muito mais.

As principais funcionalidades da Cloud Translation - Advanced API são:

  • Acesso a mais modelos: escolha o modelo certo para si entre os modelos de tradução de última geração, como o LLM de tradução, o modelo de tradução automática neural (NMT) da Google, os modelos de tradução adaptativa ou os modelos NMT personalizados que criou ou que outra pessoa criou.

  • Glossários: crie um dicionário personalizado para traduzir corretamente e de forma consistente termos específicos do domínio.

  • Pedidos em lote: faça pedidos assíncronos para traduzir grandes quantidades de texto.

  • Tradução de documentos: traduza documentos, como ficheiros PDF, para preservar o formato e o esquema originais.

  • Funções da IAM: proteja os seus pedidos de tradução através da gestão de identidade e de acesso. Criar contas de serviço e conceder-lhes autorizações através da adição de funções de IAM. A Cloud Translation - Advanced API não suporta chaves da API.

  • Etiquetas: adicione etiquetas definidas pelo utilizador (pares de chave/valor) aos seus pedidos de tradução para acompanhar melhor a utilização e receber relatórios de faturação detalhados.

  • Ponto final regional: exerça controlo sobre onde os recursos do seu projeto são armazenados e processados.

Glossários

Um glossário é um dicionário personalizado que a Cloud Translation - Advanced API usa para traduzir corretamente e de forma consistente termos específicos do domínio, entidades com nomes e outros tipos de termos que são específicos para si. Por exemplo, pode usar um glossário para especificar uma tradução específica para termos como "Google Summer of Code", "modo confidencial do Gmail" ou "relatório de desempenho do posicionamento".

Também pode usar glossários para impedir a tradução de determinadas palavras, como palavras emprestadas ou nomes de produtos. Para ver informações sobre como usar glossários, consulte o artigo Criar e usar glossários.

Pedidos em lote

Os pedidos de tradução em lote são pedidos assíncronos que traduzem a entrada de contentores do Cloud Storage. A Cloud Translation - Advanced API executa a tradução em lote como uma operação de longa duração e escreve o resultado num contentor do Cloud Storage que especificar. Os pedidos inline de tradução em lote não são suportados.

Para obter informações sobre como fazer pedidos em lote, consulte o artigo Pedidos em lote (avançado).

Tradução de documentos

A tradução de documentos permite-lhe traduzir diretamente documentos existentes, como ficheiros PDF e DOCX, para um idioma de destino. A tradução de documentos preserva o formato original para que os documentos traduzidos tenham o mesmo esquema e formato que os documentos originais. Por exemplo, a tradução de documentos mantém as quebras de parágrafos e os cabeçalhos para que o conteúdo traduzido seja dividido como no documento original.

As funcionalidades da API Cloud Translation Advanced, como glossários e modelos do AutoML, também funcionam com a Tradução de documentos. Por exemplo, se tiver um modelo do AutoML existente que usa para traduções de texto, pode usar esse mesmo modelo para a Tradução de documentos. Para mais informações sobre os tipos de ficheiros suportados e como traduzir documentos, consulte o artigo Traduza documentos.

Seleção de modelos e modelos da AutoML

A seleção de modelos da API Cloud Translation – Advanced permite-lhe selecionar dinamicamente o modelo certo para a sua aplicação entre o LLM de tradução (que também pode personalizar ainda mais para traduções adaptativas), o modelo NMT da Google ou os modelos de tradução AutoML personalizados, consoante o contexto e o conteúdo que está a traduzir.

Crie um modelo personalizado com o AutoML Translation para obter traduções mais precisas para terminologia específica do domínio. Em seguida, pode usar o modelo resultante na API Cloud Translation - Advanced para traduzir texto.

Para obter informações sobre a utilização de modelos personalizados para traduzir texto, consulte o artigo Traduzir texto (avançado).

Funções de IAM

A API Cloud Translation - Advanced integra-se com a IAM para oferecer segurança adicional para os seus pedidos de tradução, ativar o controlo de acesso detalhado e suportar a integração com o AutoML Translation.

Tem de adicionar utilizadores e contas de serviço a uma das seguintes funções para conceder a essas contas acesso à API Cloud Translation - Advanced. Para obter informações sobre como criar contas de serviço, consulte o artigo Criar e gerir contas de serviço na documentação da IAM.

Função ID da função Descrição
Visualizador da Cloud Translation API roles/cloudtranslate.viewer Pode aceder às operações de obtenção e listagem.
Utilizador da API Cloud Translation roles/cloudtranslate.user

Inclui as autorizações de roles/cloudtranslate.viewer. Pode traduzir texto usando os modelos de TNA e AutoML Translation no modo online e assíncrono (em lote). Pode usar a tradução de documentos. Pode detetar o idioma. Pode listar os idiomas suportados para os modelos de NMT e AutoML Translation. Pode usar glossários para a tradução.
Editor da API Cloud Translation roles/cloudtranslate.editor

Inclui as autorizações de roles/cloudtranslate.user e pode criar e eliminar glossários, bem como cancelar ou eliminar operações de longa duração.
Administrador da API Cloud Translation roles/cloudtranslate.admin

Inclui as autorizações de roles/cloudtranslate.editor, e pode definir políticas IAM e conceder autorizações IAM para a API Cloud Translation. Tem todas as autorizações de IAM para a Cloud Translation API.

Para ver uma lista das autorizações incluídas em cada função, consulte o artigo Compreender as funções.

Estas funções pré-configuradas abordam muitos exemplos de utilização típicos. No entanto, pode precisar de uma função que inclua um conjunto personalizado de autorizações. Por exemplo, pode querer criar uma função que permita a um utilizador criar um glossário num projeto, sem lhe permitir eliminar ou atualizar glossários existentes no projeto. Nesses casos, pode criar uma função personalizada do IAM que satisfaça as suas necessidades.

Para obter informações sobre a gestão de funções de IAM, consulte os artigos Conceder, alterar e revogar o acesso a recursos e Conceder funções a contas de serviço.

Etiquetas

A API Cloud Translation - Advanced suporta a adição de etiquetas definidas pelo utilizador (pares de chave-valor) a pedidos TranslateText, BatchTranslateText e DetectLanguage. As informações sobre a utilização de um pedido são encaminhadas para o sistema de faturação, onde pode discriminar os custos de faturação filtrando as suas etiquetas.

Para mais informações acerca das etiquetas definidas pelo utilizador, consulte o artigo Relatórios de utilização com etiquetas (avançado).

Ponto final regional

Por predefinição, a API Cloud Translation – Advanced armazena e processa recursos numa localização global, o que significa que não existe garantia de que os recursos permaneçam numa localização específica. Em vez de usar o ponto final global predefinido, pode usar um ponto final regional para manter os recursos numa localização específica, como a União Europeia. Para mais informações, consulte o artigo Especifique um ponto final regional.

Comparação de edições

A tabela seguinte mostra as funcionalidades disponíveis em cada edição.

Funcionalidade Básico Avançado
Traduza com o modelo NMT
Traduza com o LLM de tradução
Traduza com modelos de tradução adaptativa
Traduza com modelos personalizados
Traduza várias strings num único pedido
Traduções em lote com o Cloud Storage
Traduza documentos
Suporte do glossário (terminologia de controlo)
Prepare modelos personalizados
Deteção de idioma
API REST integrada
API gRPC integrada
Conta de serviço
Chave de API
Registo de auditoria
Suporta HTML
Suporta mais de 100 idiomas
Suporte de romanização
Suporte de transliteração
Tradução adaptável
Suporte de pontos finais multirregionais
Suporte dos VPC Service Controls

Consulte o artigo Cloud Translation – Funcionalidades da API Advanced para mais detalhes sobre a API Cloud Translation – Advanced.

Preços

A Cloud Translation API cobra-lhe mensalmente com base no número de carateres que envia. Para mais informações, consulte a secção Preços.

Recursos e outras leituras