Ü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, kann die Cloud Translation API sie für Sie ermitteln. 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.

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.

Cloud Translation – Basic API

Auf die Basic-Version wird über v2-Clientbibliotheken zugegriffen und sie erfordert nur eine minimale Konfiguration. Sie akzeptiert API-Schlüssel für die Authentifizierung sowie Dienstkonten und verwendet das vortrainierte NMT-Modell (Neural Machine Translation) von Google ohne Änderungen. Diese Version eignet sich gut für Anwendungen, die von Nutzern erstellte Inhalte wie Chat, soziale Medien oder Kommentare übersetzen müssen.

Standardmäßig wird in der Cloud Translation API die Basic-Version verwendet, die von Google in einem semiregulären Rhythmus aktualisiert wird, wenn mehr Trainingsdaten und bessere Techniken verfügbar sind.

Wenn Sie ein neues Projekt planen, sollten Sie jedoch die Advanced-Version wählen, um von besserer Sicherheit, mehr Funktionen und den neuen Dienstverbesserungen zu profitieren, die in der Advanced-Version 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 Übersetzungs-LLM-Modell, das NMÜ-Modell und NMÜ-Anpassungen. Außerdem bietet es Funktionen wie Glossare, Batchübersetzung und Dokumentübersetzung.

Die wichtigsten Features der Cloud Translation Advanced API sind:

  • Zugriff auf weitere Modelle: Sie können das für Sie passende Modell aus hochmodernen Übersetzungsmodellen wie dem Translation LLM, dem NMÜ-Modell (neuronale maschinelle Übersetzung) von Google, adaptiven Übersetzungsmodellen oder benutzerdefinierten NMÜ-Modellen auswählen, die von Ihnen oder einer anderen Person erstellt wurden.

  • Glossare: Sie können ein benutzerdefiniertes Wörterbuch erstellen, damit fachspezifische Begriffe korrekt und konsistent übersetzt werden.

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

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

  • IAM-Rollen: Sie können Ihre Übersetzungsanfragen mit Identity and Access Management schützen. Dazu erstellen Sie Dienstkonten und gewähren ihnen durch Hinzufügen von IAM-Rollen Berechtigungen. 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 besser zu erfassen und detaillierte Abrechnungsberichte zu erhalten.

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

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.

Informationen zum Stellen von Batchanfragen finden Sie unter Batchanfragen (Advanced).

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 der Dokumentübersetzung Absatzumbrüche und Überschriften übernommen, sodass der übersetzte Inhalt wie im Originaldokument gegliedert ist.

Features der Cloud Translation Advanced API wie Glossare und AutoML-Modelle sind auch mit der Dokumentübersetzung verfügbar. Wenn Sie beispielsweise ein AutoML-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.

Modellauswahl und AutoML-Modelle

Mit der Modellauswahl für die Cloud Translation Advanced API können Sie je nach Kontext und Inhalt, der übersetzt werden soll, dynamisch das richtige Modell für Ihre Anwendung auswählen. Zur Auswahl stehen das Translation LLM (das Sie auch für adaptive Übersetzungen weiter anpassen können), das NMÜ-Modell (neuronale maschinelle Übersetzung) von Google oder benutzerdefinierte AutoML Translation-Modelle.

Mit AutoML Translation haben Sie die Möglichkeit, ein benutzerdefiniertes Modell zu erstellen, das eine exaktere Übersetzung der fachspezifischen Terminologie ermöglicht. Dieses Modell können Sie dann in der Cloud Translation Advanced API zum Übersetzen von Text verwenden.

Informationen zum Verwenden von benutzerdefinierten Modellen zum Übersetzen von Text finden Sie unter Text übersetzen (Advanced).

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 AutoML Translation.

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 den NMÜ- und AutoML Translation-Modellen im Online- und asynchronen Modus (Batchverarbeitung) übersetzen. Darf die Dokumentübersetzung nutzen. Darf die Spracherkennung nutzen. Darf unterstützte Sprachen für die NMÜ- und AutoML Translation-Modelle auflisten. Darf Glossare für die Übersetzung verwenden.
Cloud Translation API Editor 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