Übersicht über die Cloud Translation API

Mit der Cloud Translation API kann Text für mehr als 100 Sprachpaare übersetzt werden. Wenn Sie die Sprache Ihres Quelltextes nicht kennen, wird er von der Cloud Translation API ermittelt. Eine Liste aller unterstützten Sprachen finden Sie unter Unterstützte Sprachen.

Als Unternehmensorganisation können Sie übersetzten Text in vorhandene interne Workflows einbinden. Angenommen, Sie haben ein globales Supportteam, das Kundenfälle in vielen verschiedenen Sprachen bearbeiten muss. Sie können dann die Cloud Translation API in Ihren Workflow einbinden, damit diese Kundenfälle in die Sprache übersetzt werden, die von den Mitgliedern Ihres Supportteams gesprochen wird. Mit der Cloud Translation API verbessern Sie damit die allgemeine Effizienz Ihres Supportteams, da es Texte nicht mehr manuell übersetzen oder an andere zur Übersetzung weiterleiten muss.

Die Cloud Translation API skaliert nahtlos und ermöglicht die Übersetzung einer unbegrenzten Anzahl an Zeichen pro Tag. Es gibt allerdings Einschränkungen hinsichtlich der Größe des Inhalts jeder Anfrage und der Anforderungsrate. Außerdem können Sie mithilfe von Kontingentlimits Ihr Budget individuell festlegen. Weitere Informationen finden Sie unter Kontingente und Limits.

Cloud Translation API-Versionen und -Modelle

Die Cloud Translation API ist in zwei verschiedenen Versionen verfügbar: Basic und Advanced. Eine Liste der verschiedenen Funktionen, die von den einzelnen Versionen unterstützt werden, finden Sie im Versionsvergleich.

Sie haben eine Auswahl an Modellen, sodass Sie das für Ihre spezielle Anwendung geeignete Modell auswählen können.

Cloud Translation – Basic API

Auf die Basic-Version wird über Clientbibliotheken der Version 2 zugegriffen. Sie erfordert nur eine minimale Konfiguration und akzeptiert API-Schlüssel für die Authentifizierung sowie Dienstkonten. Sie bietet nur Zugriff auf das unveränderte NMÜ-Modell (neuronale maschinelle Übersetzung) von Google. Diese Version eignet sich gut für Anwendungen, die von Nutzern erstellte Inhalte wie Chat, soziale Medien oder Kommentare übersetzen müssen.

Wenn Sie ein neues Projekt planen, sollten Sie die Advanced-Edition anstelle der Basic-Edition auswählen, um von besserer Sicherheit, mehr Funktionen und den neuen Dienstverbesserungen zu profitieren, die in der Advanced-Edition auch in Zukunft vorgenommen werden.

Cloud Translation – Advanced API

Auf die Advanced-Version wird über Clientbibliotheken der Version 3 zugegriffen. Sie erfordert eine Dienstkonto-Authentifizierung, die in IAM-Rollen integriert ist. Es bietet eine Auswahl an Modellen, darunter das aktuelle Translation LLM (TLLM) sowie das NMÜ-Modell mit und ohne Anpassung. Außerdem bietet es Funktionen wie Glossare, Batchübersetzung und Dokumentübersetzung:

  • Glossare: Ein Glossar ist ein benutzerdefiniertes Wörterbuch, das Sie erstellen, um fachspezifische Begriffe korrekt und konsistent zu übersetzen.

  • Batchanfragen: Mit Batchanfragen können Sie asynchrone Anfragen zum Übersetzen großer Textmengen stellen.

  • Dokumentübersetzung: Mit dieser Funktion können Sie Dokumente wie PDF-Dateien übersetzen und dabei das ursprüngliche Format und Layout beibehalten.

  • IAM-Rollen: Mit IAM-Rollen können Sie Ihre Übersetzungsanfragen über Identity and Access Management schützen. Sie können Dienstkonten erstellen und ihnen Berechtigungen über IAM-Rollen zuweisen. Die Cloud Translation Advanced API unterstützt keine API-Schlüssel.

  • Labels: Sie können Ihren Übersetzungsanfragen benutzerdefinierte Labels (Schlüssel/Wert-Paare) hinzufügen, um die Nutzung zu erfassen und detaillierte Abrechnungsberichte zu erstellen.

  • Regionaler Endpunkt: Mit einem regionalen Endpunkt können Sie festlegen, wo die Ressourcen für Ihr Projekt gespeichert und verarbeitet werden.

Erweiterte API-Funktionen

Wenn Sie die Cloud Translation Advanced API anstelle der Cloud Translation Basic API verwenden, haben Sie Zugriff auf die folgenden Funktionen, mit denen Sie Ihre Übersetzungslösung robuster und besser an Ihren spezifischen Anwendungsfall anpassen können:

Modellauswahl und -anpassung

Mit der Cloud Translation Advanced API-Modellauswahl können Sie dynamisch verschiedene Modelle auswählen, einschließlich Modellen, die Sie an Ihre spezielle Anwendung anpassen.

Glossare

Ein Glossar ist ein benutzerdefiniertes Wörterbuch, das von der Cloud Translation Advanced API verwendet wird, um domainspezifische Begriffe, benannte Entitäten und andere für Sie spezifische Begriffe korrekt und konsistent zu übersetzen. Beispielsweise können Sie mit einem Glossar bestimmte Übersetzungen für Begriffe wie „Google Summer of Code“, „Gmail-Modus ‚Vertraulich‘“ oder „Bericht zum Anzeigen-Placement“ festlegen.

Glossare bieten auch die Möglichkeit, die Übersetzung von bestimmten Wörtern zu verhindern, z. B. Lehnwörter oder Produktnamen. Informationen zur Verwendung von Glossaren finden Sie unter Glossare erstellen und verwenden.

Batchanfragen

Batchübersetzungsanfragen sind asynchrone Anfragen, die Eingaben aus Cloud Storage-Buckets übersetzen. Die Cloud Translation Advanced API führt die Batchübersetzung als Vorgang mit langer Ausführungszeit aus und schreibt die Ausgabe in einen von Ihnen angegebenen Cloud Storage-Bucket. Inline-Anfragen für Batchübersetzungen werden nicht unterstützt.

Dokumentübersetzung

Mit der Dokumentübersetzung können Sie vorhandene Dokumente wie PDF- und DOCX-Dateien direkt in eine Zielsprache übersetzen. Dabei wird das Originalformat beibehalten, sodass die übersetzten Dokumente das gleiche Layout und Format wie die Originaldokumente haben. Beispielsweise werden mit Document Translation Absatzumbrüche und Überschriften übernommen, sodass der übersetzte Inhalt wie im Originaldokument gegliedert ist.

Features der Cloud Translation Advanced API wie Glossare und benutzerdefinierte NMÜ-Modelle sind auch mit der Dokumentübersetzung verfügbar. Wenn Sie beispielsweise bereits ein benutzerdefiniertes NMÜ-Modell für Textübersetzungen haben, können Sie dieses Modell auch für die Dokumentübersetzung verwenden. Weitere Informationen zu unterstützten Dateitypen und zum Übersetzen von Dokumenten finden Sie unter Dokumente übersetzen.

IAM-Rollen

Die Cloud Translation Advanced API ist in IAM eingebunden. Dies bietet zusätzliche Sicherheit für Ihre Übersetzungsanfragen, ermöglicht eine detaillierte Zugriffssteuerung und unterstützt die Einbindung von benutzerdefinierten NMT-Modellen.

Sie müssen eine der im Folgenden aufgeführten Rollen zu Nutzer- und Dienstkonten hinzufügen, um diesen Konten Zugriff auf die Cloud Translation Advanced API zu gewähren. Informationen zum Erstellen von Dienstkonten finden Sie in der IAM-Dokumentation unter Dienstkonten erstellen und verwalten.

Rolle Rollen-ID Beschreibung
Cloud Translation API Viewer roles/cloudtranslate.viewer Darf auf Vorgänge zum Abrufen und Auflisten zugreifen.
Cloud Translation API User roles/cloudtranslate.user

Beinhaltet die Berechtigungen von roles/cloudtranslate.viewer. Darf Text mit dem NMÜ-Modell von Google und benutzerdefinierten NMÜ-Modellen im Online- und asynchronen Modus (Batchverarbeitung) übersetzen. Darf die Dokumentübersetzung nutzen. Darf die Spracherkennung nutzen. Darf unterstützte Sprachen für NMÜ-Modelle auflisten. Darf Glossare für die Übersetzung verwenden.
Cloud Translation API-Bearbeiter roles/cloudtranslate.editor

Beinhaltet die Berechtigungen von roles/cloudtranslate.user und darf Glossare erstellen und löschen sowie lang andauernde Vorgänge abbrechen oder löschen.
Cloud Translation API Admin roles/cloudtranslate.admin

Beinhaltet die Berechtigungen von roles/cloudtranslate.editor und darf IAM-Richtlinien festlegen sowie IAM-Berechtigungen für die Cloud Translation API erteilen. Verfügt über alle IAM-Berechtigungen für die Cloud Translation API.

Eine Liste der zu den einzelnen Rollen gehörenden Berechtigungen finden Sie unter Informationen zu Rollen.

Diese vorkonfigurierten Rollen berücksichtigen viele typische Anwendungsfälle. Möglicherweise benötigen Sie jedoch eine Rolle, die einen benutzerdefinierten Satz von Berechtigungen enthält. So können Sie z. B. eine Rolle erstellen, mit der ein Nutzer ein Glossar in einem Projekt anlegen, aber vorhandene Glossare im Projekt weder löschen noch aktualisieren kann. Dazu können Sie eine benutzerdefinierte IAM-Rolle erstellen, die Ihren Anforderungen entspricht.

Informationen zum Verwalten von IAM-Rollen finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen sowie unter Dienstkonten Rollen zuweisen.

Labels

Die Cloud Translation Advanced API unterstützt das Hinzufügen benutzerdefinierter Labels (Schlüssel/Wert-Paare) zu TranslateText-, BatchTranslateText- und DetectLanguage-Anfragen. Informationen zur Nutzung einer Anfrage werden an das Abrechnungssystem weitergeleitet. Darin können Sie beispielsweise Ihre abgerechneten Gebühren durch Filtern nach Labels aufschlüsseln.

Weitere Informationen zu benutzerdefinierten Labels finden Sie unter Labels erstellen und verwalten (Advanced).

Regionaler Endpunkt

Standardmäßig speichert und verarbeitet die Cloud Translation Advanced API Ressourcen an einem globalen Standort. Deshalb ist es möglich, dass Ressourcen nicht immer an einem bestimmten Standort verbleiben. Anstatt den standardmäßigen globalen Endpunkt zu verwenden, können Sie einen regionalen Endpunkt festlegen, um Ressourcen an einem bestimmten Standort zu speichern, z. B. in der Europäischen Union. Weitere Informationen finden Sie unter Regionalen Endpunkt festlegen.

Versionsvergleich

Die folgende Tabelle zeigt, welche Features in der jeweiligen Version verfügbar sind.

Funktion Basic Erweitert
Mit dem NMÜ-Modell übersetzen
Mit dem Translation LLM übersetzen
Mit adaptiven Übersetzungsmodellen übersetzen
Mit benutzerdefinierten Modellen übersetzen
Mehrere Strings in einer einzigen Anfrage übersetzen
Batchübersetzungen mit Cloud Storage
Dokumente übersetzen
Glossar-Unterstützung (Kontrollterminologie)
Benutzerdefinierte Modelle trainieren
Spracherkennung
Integrierte REST API
Integrierte gRPC API
Dienstkonto
API-Schlüssel
Audit-Logging
Unterstützt HTML
Unterstützt über 100 Sprachen
Unterstützt Transkription
Unterstützt Transliteration
Adaptive Übersetzung
Unterstützt multiregionale Endpunkte
Unterstützung durch VPC Service Controls

Weitere Informationen zur Cloud Translation Advanced API finden Sie unter Cloud Translation Advanced API-Funktionen.

Preise

Die Abrechnung der Cloud Translation API erfolgt monatlich nach der Anzahl der gesendeten Zeichen. Weitere Informationen finden Sie unter Preise.

Ressourcen und weiterführende Informationen