Visão geral da API Cloud Translation

A API Cloud Translation pode traduzir textos para mais de 100 pares de idiomas. Se você não souber o idioma do seu texto de origem, a API Cloud Translation poderá detectá-lo para você. Para uma lista de todos os idiomas com suporte, consulte Idiomas com suporte.

Para a organização empresarial, inclua textos traduzidos em fluxos de trabalho internos que já existem. Por exemplo, talvez você tenha uma equipe de suporte global que recebe casos de clientes em vários idiomas diferentes. Adicione a API Cloud Translation ao fluxo de trabalho para traduzir esses casos de clientes no idioma falado pelos membros da equipe de suporte. Ao usar a API Cloud Translation, você melhora a eficiência geral da sua equipe de suporte porque ela não precisará traduzir o texto manualmente ou depender de terceiros.

A API Cloud Translation é dimensionada perfeitamente e permite traduções com caracteres ilimitados por dia. No entanto, há restrições de tamanho de conteúdo para cada solicitação e taxas de solicitação. Além disso, é possível usar limites de cota para gerenciar seu orçamento. Para mais informações, consulte Cotas e limites.

Edições e modelos da API Cloud Translation

A API Cloud Translation está disponível em duas edições diferentes: a Basic e a Advanced. Para uma lista dos diferentes recursos com suporte em cada edição, consulte a comparação de edições.

Ela oferece uma opção de modelos, para que você possa escolher um adequado ao seu aplicativo específico.

API Cloud Translation - Basic

A edição Basic é acessada pelas bibliotecas de cliente da v2, e exige configuração mínima, aceitando chaves de API para autenticação e contas de serviço. Ela só dá acesso ao modelo de tradução automática neural (NMT, na sigla em inglês) do Google não modificado. É uma boa opção para aplicativos que precisam traduzir conteúdo casual gerado pelo usuário, como chat, mídias sociais ou comentários.

Se você estiver planejando um novo projeto, escolha a edição Advanced em vez da Basic para aproveitar a melhor segurança, mais recursos e as novas melhorias de serviço que a edição Advanced continuará a fazer no futuro.

API Cloud Translation - Advanced

A edição Advanced é acessada por bibliotecas de cliente da v3 e exige autenticação de conta de serviço integrada a papéis do IAM. Ela oferece uma opção de modelos, incluindo o mais recente modelo de LLM de tradução (TLLM, na sigla em inglês) e o modelo NMT com e sem personalização. Ela também oferece recursos como glossários, tradução em lote, tradução de documentos e muito mais:

  • Glossários: um glossário é um dicionário personalizado que você cria para traduzir termos específicos do domínio de maneira correta e consistente.

  • Solicitações em lote: as solicitações em lote permitem fazer solicitações assíncronas que traduzem grandes quantidades de texto.

  • Tradução de documentos: esse recurso permite traduzir documentos, como arquivos PDF, preservando o formato e o layout originais.

  • Papéis do IAM: os papéis do IAM permitem proteger suas solicitações de tradução usando Identity and Access Management. É possível criar contas de serviço e conceder permissões a elas usando papéis do IAM. A API Cloud Translation - Advanced não oferece suporte a chaves de API.

  • Rótulos: adicione rótulos definidos pelo usuário (pares de chave-valor) às solicitações de tradução para acompanhar o uso e ativar relatórios de faturamento detalhados.

  • Endpoint regional: usando um endpoint regional, você pode exercer controle sobre onde os recursos do seu projeto são armazenados e tratados.

Recursos avançados da API

O uso da API Cloud Translation - Advanced em vez da API Cloud Translation - Basic oferece acesso aos seguintes recursos que podem tornar sua solução de tradução mais robusta e adequada ao seu caso de uso específico:

Seleção e personalização de modelos

A seleção de modelos da API Cloud Translation - Advanced permite selecionar dinamicamente diferentes modelos, incluindo aqueles que você personaliza para se adequar ao seu aplicativo específico.

Glossários

Um glossário é um dicionário personalizado que a API Cloud Translation - Advanced usa para traduzir de maneira correta e consistente termos específicos do domínio, entidades nomeadas e outros tipos de termos específicos para você. Por exemplo, é possível 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 performance em canais".

Também é possível usar glossários para evitar que algumas palavras sejam traduzidas, como palavras emprestadas ou nomes de produtos. Para informações sobre como usar glossários, consulte Como criar e usar glossários.

Solicitações em lote

As solicitações de tradução em lote são solicitações assíncronas que traduzem a entrada dos buckets do Cloud Storage. A API Cloud Translation - Advanced executa a tradução em lote como uma operação de longa duração e grava a saída em um bucket do Cloud Storage especificado. Não há suporte a solicitações inline para tradução em lote.

Document Translation

A Document Translation permite traduzir diretamente documentos, como arquivos PDF e DOCX, para um idioma-alvo. Ela preserva o formato original para que os documentos traduzidos tenham o mesmo layout e formato que os documentos originais. Por exemplo, a Document Translation mantém quebras de parágrafo e cabeçalhos para que o conteúdo traduzido seja dividido da mesma forma que no documento original.

Os recursos da API Cloud Translation - Advanced, como glossários e modelos NMT personalizados, também funcionam com a Document Translation. Por exemplo, se você já tiver um modelo NMT personalizado que usa para traduções de texto, será possível usá-lo para a Document Translation. Para mais informações sobre os tipos de arquivos com suporte e como traduzir documentos, consulte Traduzir documentos.

Papéis IAM

A API Cloud Translation - Advanced se integra ao IAM para fornecer mais segurança às solicitações de tradução, ativar controle de acesso minucioso e oferecer suporte à integração com modelos NMT personalizados.

É preciso adicionar usuários e contas de serviço a um dos seguintes papéis para conceder a essas contas acesso à API Cloud Translation - Advanced. Para informações sobre como criar contas de serviço, consulte Como criar e gerenciar contas de serviço na documentação do IAM.

Papel ID do papel Descrição
Leitor da API Cloud Translation roles/cloudtranslate.viewer Pode acessar as operações get e list.
Usuário da API Cloud Translation roles/cloudtranslate.user

Inclui as permissões de roles/cloudtranslate.viewer. Pode traduzir textos usando o modelo NMT do Google e modelos NMT personalizados no modo on-line e assíncrono (lote). Pode usar a Document Translation. Pode detectar o idioma. Pode listar idiomas com suporte para modelos NMT modelos. Pode usar glossários para tradução.
Editor da API Cloud Translation roles/cloudtranslate.editor

Inclui as permissões de roles/cloudtranslate.user. Também pode criar e excluir glossários, além de cancelar ou excluir operações de longa duração.
Administrador da API Cloud Translation roles/cloudtranslate.admin

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

Para acessar uma lista das permissões em cada papel, consulte Noções básicas sobre papéis.

Esses papéis pré-configurados abordam muitos casos de uso típicos. No entanto, pode ser necessário ter um papel que inclua um conjunto personalizado de permissões. Por exemplo, é possível criar um papel que permita que um usuário crie um glossário em um projeto, sem permitir que ele exclua ou atualize os glossários. Nesses casos, é possível criar um papel personalizado do IAM que atenda às suas necessidades.

Para informações sobre como gerenciar papéis do IAM, consulte Como conceder, alterar e revogar o acesso a recursos e Como conceder papéis a contas de serviço.

Rótulos

A API Cloud Translation - Advanced oferece suporte à adição de rótulos definidos pelo usuário (pares de chave-valor) às solicitações TranslateText, BatchTranslateText e DetectLanguage. As informações sobre o uso de uma solicitação são encaminhadas ao sistema de faturamento. Nele, é possível filtrar as etiquetas para detalhar as cobranças de faturamento.

Para mais informações sobre rótulos definidos pelo usuário, consulte Como gerar relatórios de uso com rótulos (Advanced).

Endpoint regional

Por padrão, a API Cloud Translation - Advanced armazena e processa recursos em um local global, o que significa que não há recursos de garantia restantes em um local específico. Em vez de usar o endpoint global padrão, é possível usar um endpoint regional para manter os recursos em um local específico, como a União Europeia. Para mais informações, consulte Especificar um endpoint regional.

Comparação de edições

A tabela a seguir mostra quais recursos estão disponíveis em cada uma das edições.

Recurso Básico Avançado
Tradução com o modelo NMT
Tradução com o LLM de tradução
Tradução com modelos da tradução adaptativa
Tradução com modelos personalizados
Tradução de várias strings em uma única solicitação
Traduções em lote com o Cloud Storage
Traduzir documentos
Suporte a glossário (controle da terminologia)
Treinar modelos personalizados
Detecção de idiomas
API REST integrada
API gRPC integrada
Conta de serviço
Chave de API
Registro de auditoria
Aceita HTML
Compatível com mais de 100 idiomas
Suporte para romanização
Suporte para transliteração
Tradução adaptativa
Suporte a endpoints multirregionais
Suporte do VPC Service Controls

Consulte Recursos da API Cloud Translation - Advanced para mais detalhes sobre a API Cloud Translation - Advanced.

Preços

A API Cloud Translation gera cobranças mensais com base no número de caracteres enviados. Para saber mais informações, consulte Preços.

Recursos e mais informações