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 precisa 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.
A API Cloud Translation está disponível em duas edições diferentes: a Basic e a Advanced. Para conferir uma lista dos diferentes recursos compatíveis com cada uma, consulte a comparação de edições.
API Cloud Translation Basic
A edição Basic é acessada pelas bibliotecas de cliente v2 e requer configuração mínima. Ele aceita chaves de API para autenticação e contas de serviço, além de usar o modelo de tradução automática neural (NMT) pré-treinado do Google sem modificação. É uma boa opção para aplicativos que precisam traduzir conteúdo casual gerado pelo usuário, como chat, mídia social ou comentários.
Por padrão, a API Cloud Translation usa a edição Basic, que o Google atualiza em uma cadência semirregular à medida que mais dados de treinamento e técnicas melhores são disponibilizados.
No entanto, se você estiver planejando um novo projeto, escolha a edição Advanced para aproveitar uma segurança melhor, mais recursos e as novas melhorias de serviço que essa edição vai continuar oferecendo.
API Cloud Translation Advanced
A edição Advanced é acessada pelas bibliotecas de cliente v3 e exige autenticação de conta de serviço integrada aos papéis do IAM. Ele oferece uma variedade de modelos, incluindo o LLM de tradução, o modelo de NMT e personalizações de NMT. Ele também oferece recursos como glossários, tradução em lote, tradução de documentos e muito mais.
Os principais recursos da API Cloud Translation Advanced são:
Acesso a mais modelos: escolha o modelo certo para você entre os modelos de tradução mais modernos, como o LLM de tradução, o modelo de tradução automática neural (NMT, na sigla em inglês) do Google, os modelos de tradução adaptativa ou os modelos personalizados de NMT que você ou outra pessoa criou.
Glossários: crie um dicionário personalizado para traduzir de forma correta e consistente termos específicos do domínio.
Solicitações em lote: faça solicitações assíncronas para traduzir grandes quantidades de texto.
Tradução de documentos: traduza documentos (como arquivos PDF) para preservar o formato e o layout originais.
Papéis do IAM: proteja suas solicitações de tradução usando o Identity and Access Management. Crie contas de serviço e conceda a elas permissões adicionando papéis do IAM. A API Cloud Translation - Advanced não é compatível com chaves de API.
Rótulos: adicione rótulos definidos pelo usuário (pares de chave-valor) às solicitações de tradução para acompanhar melhor o uso e receber relatórios de faturamento detalhados.
Endpoint regional: controle onde os recursos do seu projeto são armazenados e processados.
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 realiza 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 por você. Não há suporte a solicitações inline para tradução em lote.
Para informações sobre como fazer solicitações em lote, consulte Solicitações em lote (Advanced).
Tradução de documentos
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 como no documento original.
Os recursos da API Cloud Translation - Advanced, como glossários e modelos do AutoML, também funcionam com a Document Translation. Por exemplo, se você tiver um modelo do AutoML que é usado 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.
Seleção de modelos e modelos do AutoML
Com a seleção de modelos da API Cloud Translation - Advanced, é possível escolher dinamicamente o modelo certo para seu aplicativo entre o LLM de tradução (que também pode ser personalizado para traduções adaptativas), o modelo de NMT do Google ou modelos personalizados do AutoML Translation, dependendo do contexto e do conteúdo que você está traduzindo.
Crie um modelo personalizado usando o AutoML Translation para traduções mais precisas para a terminologia específica do domínio. Você pode usar o modelo resultante na API Cloud Translation Advanced para traduzir o texto.
Para informações sobre como usar modelos personalizados para traduzir textos, consulte Como traduzir textos (Advanced).
Papéis IAM
A API Cloud Translation - Advanced integra-se ao IAM para fornecer mais segurança às solicitações de tradução, ativar controle de acesso minucioso e oferecer suporte à integração com o AutoML Translation.
É 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 |
| Editor da API Cloud Translation | roles/cloudtranslate.editor |
Inclui as permissões de |
| Administrador da API Cloud Translation | roles/cloudtranslate.admin |
Inclui as permissões de |
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 permite adicionar 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á garantia de que os recursos permaneçam 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 | ||
| Tradução de 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 | ||
| Suporte a 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 sugestões de leitura
- Para começar a usar a API, configure-a e siga o guia de início rápido.
- Comparar modelos compatíveis
- Personalizar o modelo NMT
- Personalizar o LLM de tradução
- Idiomas disponíveis
- Formatos compatíveis
- Fazer uma tradução adaptativa
- Migrar para o Translation Advanced
- Para respostas a perguntas gerais sobre a API Cloud Translation, consulte a página Perguntas frequentes gerais.