Vorbereitung

Text-to-Speech ist eine API, die auf der künstlichen Intelligenz (KI) von Google basiert. Sie senden Ihre Transkriptdaten in einem API-Aufruf an Text-to-Speech und erhalten dann natürlich klingende, synthetische menschliche Sprache als Audiowiedergabe. Weitere Informationen zur Funktionsweise von Text-to-Speech finden Sie auf der Seite Grundlagen.

Wir stellen Codebeispiele bereit, die zeigen, wie Sie eine Anfrage an die API senden und eine Antwort erhalten. Informationen zur Verwendung dieser Beispiele finden Sie in den Kurzanleitungen und den Anleitungen für Text-to-Speech.

In diesem Leitfaden erfahren Sie, wie Sie Anfragen an die Text-to-Speech API senden.

Übersicht

Bevor Sie Text-to-Speech verwenden können, müssen Sie die API in der Google Cloud Platform Console aktivieren. Die unten stehenden Schritte führen Sie durch die folgenden Aktionen:

  • Text-to-Speech für ein Projekt aktivieren.
    1. Die Abrechnung muss für Text-to-Speech aktiviert sein.
    2. Achten Sie darauf, dass Ihr Projekt mindestens ein Dienstkonto hat.
    3. Laden Sie einen Anmeldeinformationsschlüssel für das Dienstkonto herunter.
  • Legen Sie Ihre Authentifizierungsumgebungsvariable fest.

Google Cloud Platform-Projekt einrichten

  1. Bei der Cloud Console anmelden

  2. Zur Projektauswahl

    Sie können entweder ein vorhandenes Projekt auswählen oder ein neues erstellen. Weitere Informationen zum Erstellen eines Projekts finden Sie in der Google Cloud Platform-Dokumentation.

  3. Wenn Sie ein neues Projekt erstellen, werden Sie aufgefordert, ein Abrechnungskonto mit diesem Projekt zu verknüpfen. Wenn Sie ein bereits vorhandenes Projekt verwenden, muss die Abrechnung aktiviert sein.

    So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist

  4. Nachdem Sie ein Projekt ausgewählt und mit einem Rechnungskonto verknüpft haben, können Sie die Text-to-Speech API aktivieren. Öffnen Sie oben auf der Seite die Leiste Produkte und Ressourcen suchen und geben Sie speech ein. Wählen Sie aus der Liste der Ergebnisse die Cloud Text-to-Speech API aus.

  5. Wenn Sie Text-to-Speech testen möchten, ohne es mit Ihrem Projekt zu verknüpfen, wählen Sie die Option DIESE API TESTEN. Klicken Sie auf AKTIVIEREN, um die Text-to-Speech API für Ihr Projekt zu aktivieren.

  6. Sie müssen nun ein oder mehrere Dienstkonten mit der Text-to-Speech API verknüpfen. Klicken Sie links auf der Seite "Text-to-Speech API" auf den Link Anmeldedaten:

    Wenn mit diesem Projekt keine Dienstkonten verknüpft sind, erstellen Sie eines anhand der Anleitung im Abschnitt Neues Dienstkonto erstellen.

    Wenn Sie zuvor Dienstkonten erstellt haben, die mit diesem Projekt verknüpft sind, werden sie auf dieser Seite angezeigt. Sie müssen Zugriff auf einen heruntergeladenen JSON-Schlüssel haben, der mit dem Dienstkonto verknüpft ist, das Sie für die Authentifizierung bei Text-to-Speech verwenden möchten. Dienstkontoschlüssel können nur einmal heruntergeladen werden, wenn sie erstellt werden. Wenn Ihr Dienstkonto einen vorhandenen Schlüssel hat, Sie die heruntergeladene Datei .json jedoch nicht finden können, müssen Sie einen neuen Schlüssel für dieses Dienstkonto erstellen und die zugehörige Datei .json herunterladen. Wie Sie einen neuen Schlüssel für ein vorhandenes Dienstkonto erstellen, erfahren Sie im Abschnitt JSON-Schlüssel erstellen.

    Wenn Sie bereits ein Dienstkonto und dessen JSON-Schlüssel haben, können Sie jetzt die Umgebungsvariable für die Authentifizierung festlegen.

Neues Dienstkonto erstellen

  1. Erstellen Sie ein neues Dienstkonto, wenn Ihr Projekt noch keines hat. Sie müssen ein Dienstkonto erstellen, um Text-to-Speech verwenden zu können.

    Zur Seite „Dienstkonto erstellen“

    Geben Sie im Feld Name des Dienstkontos einen eindeutigen Namen für das neue Dienstkonto ein. Ihre Eingabe wird automatisch in das Feld Dienstkonto-ID eingetragen. Das Feld Dienstkontobeschreibung ist optional, wird jedoch empfohlen, wenn Sie Ihrem Projekt mehrere Dienstkonten zuordnen möchten. Geben Sie eine kurze Beschreibung des Dienstkontos in dieses Feld ein und klicken Sie auf ERSTELLEN UND FORTFAHREN.

  2. Es empfiehlt sich, Ihrem Dienstkonto eine der einfachen IAM-Rollen zuzuweisen. Bei Bedarf können Sie einem einzelnen Dienstkonto auch mehrere Rollen zuweisen. Unter IAM-Rollen finden Sie Details zu den verfügbaren Rollen und den jeweils vorhandenen Berechtigungen. Klicken Sie auf das Drop-down-Menü Rolle auswählen und scrollen Sie nach unten zu Basic. Sie können eine Rolle für dieses Dienstkonto aus den Optionen auswählen, die in der rechten Spalte angezeigt werden. Klicken Sie auf WEITER.

  3. Im letzten Schritt können Sie optional anderen Entitäten (Einzelpersonen, Google-Gruppen usw.) Zugriff auf Ihr Dienstkonto gewähren. Wenn Sie keine zusätzliche Zugriffsberechtigung benötigen, klicken Sie auf FERTIG, ohne Informationen einzugeben.

  4. Das Dienstkonto wird jetzt auf der Seite Dienstkonten aufgeführt. Sie können die Berechtigungen des Dienstkontos ändern, neue Schlüssel hinzufügen oder generieren und jederzeit Zugriff gewähren.

JSON-Schlüssel für Ihr Dienstkonto erstellen

  1. Das neu erstellte Dienstkonto wird auf der Seite mit den Dienstkonten angezeigt. Erstellen Sie einen privaten Schlüssel, der mit diesem Konto verknüpft wird. Sie müssen diesen privaten Schlüssel während des Authentifizierungsprozesses verwenden, wenn Sie eine Anfrage an Text-to-Speech senden. Wenn Sie jetzt keinen Schlüssel erstellen möchten, können Sie später jederzeit einen Schlüssel generieren und/oder einzelne Nutzerinformationen ändern. Dazu rufen Sie das Dienstkonto über die Option IAM und Verwaltung -> Dienstkonten im Navigationsmenü auf.

    Zum Erstellen eines Schlüssels klicken Sie auf das Dienstkonto und wählen dann SCHLÜSSEL aus. Klicken Sie auf SCHLÜSSEL HINZUFÜGEN > Neuen Schlüssel erstellen. Wir empfehlen, Schlüssel im JSON-Format zu erstellen.

  2. Ein neuer Schlüssel im Format Ihrer Wahl wird automatisch heruntergeladen. Speichern Sie diese Datei an einem sicheren Ort und notieren Sie sich den Dateipfad. Sie müssen mit der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS auf diese Datei verweisen, wenn Sie den Authentifizierungsprozess zu Beginn jeder neuen Text-to-Speech-Sitzung durchlaufen. Dies ist ein wichtiger Schritt für die Authentifizierung von Anfragen, die an Text-to-Speech gesendet werden. Die eindeutige ID des Schlüssels wird neben dem Namen des Dienstkontos angezeigt.

Legen Sie Ihre Authentifizierungsumgebungsvariable fest

Zum Festlegen Ihrer GOOGLE_APPLICATION_CREDENTIALS müssen Sie ein Dienstkonto mit Ihrem Projekt verknüpft und Zugriff auf den JSON-Schlüssel des Dienstkontos haben.

Geben Sie die Anmeldedaten zur Authentifizierung für Ihren Anwendungscode durch Festlegung der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS an. Diese Variable gilt nur für Ihre aktuelle Shellsitzung. Wenn Sie möchten, dass die Variable für zukünftige Shell-Sitzungen gilt, legen Sie die Variable in Ihrer Shell-Startdatei fest, z. B. in der Datei ~/.bashrc oder ~/.profile.

Linux oder macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält.

Beispiel:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Für PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält.

Beispiel:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Für Eingabeaufforderung:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Geben Sie für KEY_PATH den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält.

Weitere Informationen finden Sie in der Google Cloud Platform-Authentifizierungsdokumentation.

Text-to-Speech API deaktivieren

Um die Text-to-Speech API zu deaktivieren, wechseln Sie zum Google Cloud Platform-Dashboard und klicken im Feld "APIs" auf den Link Zur API-Übersicht. Klicken Sie auf die Text-to-Speech API und wählen Sie dann oben auf der Seite die Schaltfläche API DEAKTIVIEREN aus.

Nächste Schritte

Weitere Informationen zum Senden einer Transkriptionsanfrage an die Text-to-Speech API mit Clientbibliotheken oder über die Befehlszeile.