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.
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 conferir uma lista dos diferentes recursos compatíveis com cada uma, consulte a comparação de edições.
Ele 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 v2 e exige configuração mínima, aceitando chaves de API para autenticação e contas de serviço. Ele só dá acesso ao modelo de tradução automática neural (NMT) do Google sem modificações. É uma boa opção para aplicativos que precisam traduzir conteúdo casual gerado pelo usuário, como chat, mídia social ou comentários.
Se você estiver planejando um novo projeto, escolha a edição Advanced em vez da Basic para aproveitar melhor segurança, mais recursos e as novas melhorias de serviço que a edição Advanced 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 opção de modelos, incluindo o mais recente modelo de LLM de tradução (TLLM) e o modelo de 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: com elas, é possível fazer solicitações assíncronas que traduzem grandes quantidades de texto.
Tradução de documentos: com esse recurso, é possível traduzir documentos como arquivos PDF, preservando o formato e o layout originais.
Papéis do IAM: com os papéis do IAM, você protege suas solicitações de tradução usando o 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 é 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 o uso e ativar relatórios de faturamento detalhados.
Endpoint regional: ao usar um endpoint regional, você pode controlar onde os recursos do seu projeto são armazenados e processados.
Recursos avançados da API
Usar a API Cloud Translation - Advanced em vez da API Cloud Translation - Basic dá 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
Com a seleção de modelos da API Cloud Translation Advanced, é possível escolher 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 assíncronas e 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.
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 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, poderá usar o mesmo modelo 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 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 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 |
| 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.