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.
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.
API Cloud Translation – Basic
L'édition de base est accessible via les bibliothèques clientes v2 et nécessite une configuration minimale. Elle accepte les clés API pour l'authentification ainsi que les comptes de service, et utilise le modèle de traduction automatique neuronale (NMT) pré-entraîné de Google sans aucune modification. 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.
Par défaut, l'API Cloud Translation utilise l'édition Basic, que Google met à jour à une fréquence semi-régulière lorsque davantage de données d'entraînement et de meilleures techniques deviennent disponibles.
Toutefois, si vous prévoyez de lancer un nouveau projet, vous pouvez choisir l'édition Advanced pour profiter d'une sécurité renforcée, de plus de fonctionnalités et des nouvelles améliorations du service qui continueront d'être apportées à l'édition Advanced.
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 offre un choix de modèles, y compris le modèle LLM de traduction, le modèle NMT et les personnalisations NMT. Il propose également des fonctionnalités telles que les glossaires, la traduction par lot, la traduction de documents, etc.
Voici les principales fonctionnalités de l'API Cloud Translation – Advanced :
Accès à davantage de modèles : choisissez le modèle qui vous convient parmi les modèles de traduction de pointe, comme le LLM de traduction, le modèle de traduction automatique neuronale (NMT) de Google, les modèles de traduction adaptative ou les modèles NMT personnalisés que vous ou une autre personne avez créés.
Glossaires : créez un dictionnaire personnalisé pour traduire des termes spécifiques à un domaine de manière correcte et cohérente.
Requêtes par lots : exécutez des requêtes asynchrones pour traduire d'importants volumes de texte.
Document Translation : traduisez des documents, tels que des fichiers PDF, pour conserver le format et la mise en page d'origine.
Rôles IAM : sécurisez vos requêtes de traduction à l'aide d'Identity and Access Management. Créez des comptes de service et accordez-leur des autorisations en ajoutant des rôles IAM. L'API Cloud Translation – Advanced n'est pas compatible avec les clés API.
Libellés : ajoutez des libellés définis par l'utilisateur (paires clé/valeur) à vos requêtes de traduction pour mieux suivre l'utilisation et obtenir des rapports de facturation précis.
Point de terminaison régional : contrôlez l'emplacement de stockage et de traitement des ressources de votre projet.
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 du bucket Cloud Storage. L'API Cloud Translation – Advanced effectue la traduction par lots 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.
Pour en savoir plus sur l'exécution de requêtes par lot, consultez Requêtes par lot (version Advanced).
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é comme dans le document d'origine.
Les fonctionnalités de l'API Cloud Translation – Advanced, telles que les glossaires et les modèles AutoML, fonctionnent également avec Document Translation. Par exemple, si vous disposez d'un modèle AutoML existant 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.
Sélection de modèles et modèles AutoML
La sélection de modèles de l'API Cloud Translation – Advanced vous permet de sélectionner de manière dynamique le modèle adapté à votre application parmi le LLM de traduction (que vous pouvez également personnaliser davantage pour les traductions adaptatives), le modèle NMT de Google ou les modèles AutoML Translation personnalisés, en fonction du contexte et du contenu que vous traduisez.
Créez un modèle personnalisé à l'aide d'AutoML Translation pour obtenir des traductions plus précises pour une terminologie spécifique à un domaine. Vous pouvez ensuite utiliser le modèle obtenu dans l'API Cloud Translation Advanced pour traduire du texte.
Pour savoir comment utiliser des modèles personnalisés pour traduire du texte, consultez Traduire du texte (version Advanced).
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 à AutoML Translation.
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.