Présentation de l'API Cloud Translation
L'API Cloud Translation peut traduire du texte pour plus de 100 combinaisons linguistiques. Si vous ne connaissez pas la langue de votre texte source, l'API Cloud Translation peut la détecter pour vous. Pour obtenir la liste de toutes les langues disponibles, consultez Langues acceptées.
En tant qu'entreprise, vous pouvez inclure du texte traduit dans les workflows internes existants. Par exemple, vous pouvez avoir une équipe d'assistance mondiale qui reçoit les demandes des clients dans de nombreuses langues. Vous pouvez ajouter l'API Cloud Translation à votre workflow pour traduire ces demandes client dans la langue parlée par les membres de votre équipe d'assistance. En utilisant l'API Cloud Translation, vous améliorez l'efficacité globale de votre équipe d'assistance, car elle n'a pas besoin de traduire manuellement le texte ou de dépendre d'autres personnes.
L'API Cloud Translation s'adapte facilement et permet un nombre illimité de traductions de caractères par jour. Toutefois, il existe des restrictions sur la taille du contenu pour chaque requête et des taux de requêtes. De plus, vous pouvez utiliser des limites de quota pour gérer votre budget. Pour en savoir plus, consultez la page Quotas et limites.
Éditions et modèles de l'API Cloud Translation
L'API Cloud Translation est disponible en deux éditions : Basic et Advanced. Pour obtenir la liste des différentes fonctionnalités compatibles avec chaque édition, consultez la comparaison des éditions.
Il vous offre un choix de modèles pour que vous puissiez en sélectionner un adapté à votre application.
API Cloud Translation – Basic
L'édition de base est accessible via les bibliothèques clientes v2. Elle nécessite une configuration minimale et accepte les clés API pour l'authentification, ainsi que les comptes de service. Il ne donne accès qu'au modèle de traduction automatique neuronale (NMT) de Google non modifié. Elle est particulièrement adaptée aux applications qui doivent traduire du contenu informel généré par des utilisateurs, tel que des chats, des réseaux sociaux ou des commentaires.
Si vous prévoyez de lancer un nouveau projet, vous pouvez choisir l'édition Advanced plutôt que l'édition Basic. Vous profiterez ainsi d'une meilleure sécurité, de plus de fonctionnalités et des nouvelles améliorations du service que l'édition Advanced continuera d'apporter à l'avenir.
API Cloud Translation – Advanced
L'édition Advanced est accessible via les bibliothèques clientes v3 et nécessite une authentification par compte de service intégrée aux rôles IAM. Il propose un choix de modèles, y compris le dernier modèle LLM de traduction (TLLM), ainsi que le modèle NMT avec ou sans personnalisation. Il propose également des fonctionnalités telles que les glossaires, la traduction par lots, la traduction de documents, etc. :
Glossaires : un glossaire est un dictionnaire personnalisé que vous créez pour traduire des termes spécifiques à un domaine de manière correcte et cohérente.
Requêtes par lots : les requêtes par lots vous permettent d'effectuer des requêtes asynchrones pour traduire d'importants volumes de texte.
Document Translation : cette fonctionnalité vous permet de traduire des documents tels que des fichiers PDF tout en conservant leur format et leur mise en page d'origine.
Rôles IAM : les rôles IAM vous permettent de sécuriser vos demandes de traduction à l'aide d'Identity and Access Management. Vous pouvez créer des comptes de service et leur accorder des autorisations à l'aide de rôles IAM. Notez que l'API Cloud Translation – Advanced n'est pas compatible avec les clés API.
Libellés : vous pouvez ajouter des libellés définis par l'utilisateur (paires clé/valeur) à vos requêtes de traduction pour suivre l'utilisation et générer des rapports de facturation précis.
Point de terminaison régional : en utilisant un point de terminaison régional, vous pouvez contrôler l'emplacement de stockage et de traitement des ressources de votre projet.
Fonctionnalités avancées de l'API
L'utilisation de l'API Cloud Translation – Advanced plutôt que l'API Cloud Translation – Basic vous donne accès aux fonctionnalités suivantes, qui peuvent rendre votre solution de traduction plus robuste et mieux adaptée à votre cas d'utilisation spécifique :
Sélection et personnalisation des modèles
La sélection de modèles d'API Cloud Translation – Advanced vous permet de sélectionner dynamiquement différents modèles, y compris ceux que vous personnalisez pour les adapter à votre application.
Glossaires
Un glossaire est un dictionnaire personnalisé qui permet à l'API Cloud Translation – Advanced de traduire correctement et de manière cohérente des termes spécifiques à un domaine, des entités nommées et d'autres types de termes qui vous sont propres. Par exemple, vous pouvez employer un glossaire pour indiquer une traduction spécifique pour des termes tels que "Google Summer of Code", "mode confidentiel de Gmail" ou "rapport sur les performances des emplacements".
Vous pouvez également utiliser des glossaires pour empêcher la traduction de certains mots, tels que des mots empruntés ou des noms de produits. Pour en savoir plus sur l'utilisation des glossaires, consultez Créer et utiliser des glossaires.
Requêtes par lot
Les requêtes de traduction par lots sont des requêtes asynchrones qui traduisent les entrées des buckets Cloud Storage. L'API Cloud Translation – Advanced effectue la traduction par lot en tant qu'opération de longue durée et écrit le résultat dans un bucket Cloud Storage que vous spécifiez. Les requêtes intégrées pour la traduction par lot ne sont pas acceptées.
Document Translation
Document Translation vous permet de traduire directement des documents existants, tels que des fichiers PDF et DOCX, dans une langue cible. Document Translation conserve le format d'origine afin que les documents traduits aient la même mise en page et le même format que les documents d'origine. Par exemple, Document Translation conserve les sauts de paragraphe et les titres afin que votre contenu traduit soit divisé de la même manière que dans le document d'origine.
Les fonctionnalités de l'API Cloud Translation – Advanced, telles que les glossaires et les modèles NMT personnalisés, fonctionnent également avec Document Translation. Par exemple, si vous disposez déjà d'un modèle NMT personnalisé que vous utilisez pour les traductions de texte, vous pouvez utiliser ce même modèle pour Document Translation. Pour en savoir plus sur les types de fichiers compatibles et sur la traduction de documents, consultez Traduire des documents.
Rôles IAM
L'API Cloud Translation – Advanced s'intègre à IAM pour renforcer la sécurité de vos requêtes de traduction, permettre un contrôle des accès ultraprécis et assurer l'intégration aux modèles NMT personnalisés.
Vous devez ajouter des utilisateurs et des comptes de service à l'un des rôles suivants pour leur permettre d'accéder à l'API Cloud Translation – Advanced. Pour en savoir plus sur la création de comptes de service, consultez Créer et gérer des comptes de service dans la documentation IAM.
| Rôle | ID de rôle | Description |
|---|---|---|
| Lecteur de l'API Cloud Translation | roles/cloudtranslate.viewer |
Peut accéder aux opérations Get et List. |
| Utilisateur de l'API Cloud Translation | roles/cloudtranslate.user |
Inclut les autorisations du rôle |
| Éditeur de l'API Cloud Translation | roles/cloudtranslate.editor |
Inclut les autorisations du rôle |
| Administrateur de l'API Cloud Translation | roles/cloudtranslate.admin |
Inclut les autorisations du rôle |
Pour obtenir la liste des autorisations contenues dans chaque rôle, consultez Comprendre les rôles.
Ces rôles préconfigurés répondent à de nombreux cas d'utilisation typiques. Cependant, vous pouvez avoir besoin d'un rôle comprenant un ensemble d'autorisations personnalisé. Par exemple, imaginons que vous souhaitez créer un rôle permettant à un utilisateur de créer un glossaire dans un projet, sans l'autoriser à supprimer ou à mettre à jour les glossaires existant dans le projet. Dans ce cas, vous pouvez créer un rôle personnalisé IAM répondant à vos besoins.
Pour en savoir plus sur la gestion des rôles IAM, consultez les pages Accorder, modifier et révoquer les accès à des ressources et Attribuer des rôles aux comptes de service.
Étiquettes
L'API Cloud Translation – Advanced permet d'ajouter des libellés définis par l'utilisateur (paires clé/valeur) aux requêtes TranslateText, BatchTranslateText et DetectLanguage.
Les informations sur l'utilisation d'une requête sont transmises au système de facturation, dans lequel vous pouvez consulter le détail des frais apparaissant sur votre facture en fonction des libellés.
Pour en savoir plus sur les libellés définis par l'utilisateur, consultez Signaler l'utilisation avec des libellés (version Advanced).
Point de terminaison régional
Par défaut, l'API Cloud Translation – Advanced stocke et traite les ressources dans un emplacement mondial, ce qui signifie qu'il n'y a aucune garantie qu'elles restent dans un emplacement particulier. Au lieu d'utiliser le point de terminaison mondial par défaut, vous pouvez utiliser un point de terminaison régional pour conserver des ressources dans un emplacement particulier, tel que l'Union européenne. Pour en savoir plus, consultez Spécifier un point de terminaison régional.
Comparatif des éditions
Le tableau suivant indique les fonctionnalités disponibles dans chaque édition.
| Fonctionnalité | Basic | Avancé |
|---|---|---|
| Traduire avec le modèle NMT | ||
| Traduire avec le LLM de traduction | ||
| Traduire avec des modèles de traduction adaptative | ||
| Traduction avec des modèles personnalisés | ||
| Traduction de plusieurs chaînes via une seule requête | ||
| Traductions par lot avec Cloud Storage | ||
| Traduire des documents | ||
| Glossaire intégré à l'API (terminologie de contrôle) | ||
| Modèles personnalisés entraînés | ||
| Détection de la langue | ||
| API REST intégrée | ||
| API gRPC intégrée | ||
| Compte de service | ||
| Clé API | ||
| Journaux d'audit | ||
| Compatibilité avec HTML | ||
| Plus de 100 langues acceptées | ||
| Compatibilité avec la romanisation | ||
| Compatibilité avec la translittération | ||
| Traduction adaptative | ||
| Compatibilité avec les points de terminaison multirégionaux | ||
| Compatibilité avec VPC Service Controls |
Pour en savoir plus sur l'API Cloud Translation – Advanced, consultez Fonctionnalités de l'API Cloud Translation – Advanced.
Tarifs
L'API Cloud Translation vous facture sur une base mensuelle en fonction du nombre de caractères que vous envoyez. Pour en savoir plus, reportez-vous à la section Tarification.
Ressources et lectures complémentaires
- Pour commencer à utiliser l'API, définissez la configuration, puis consultez le guide de démarrage rapide.
- Comparer les modèles compatibles
- Personnaliser le modèle NMT
- Personnaliser le LLM de traduction
- Langues disponibles
- Formats compatibles
- Effectuer une traduction adaptative
- Migrer vers Translation Advanced
- Pour obtenir des réponses aux questions d'ordre général sur l'API Cloud Translation, consultez la page Questions fréquentes générales.