Package google.cloud.speech.v1p1beta1

Index

Anpassung

Dienst, der die Google Cloud Speech Adaptation API implementiert.

CreateCustomClass

rpc CreateCustomClass(CreateCustomClassRequest) returns (CustomClass)

Benutzerdefinierte Klasse erstellen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

CreatePhraseSet

rpc CreatePhraseSet(CreatePhraseSetRequest) returns (PhraseSet)

Erstellen Sie eine Reihe von Wortgruppen-Hinweisen. Jedes Element im Set kann ein einzelnes Wort oder eine Wortgruppe sein. Die Elemente im PhraseSet werden vom Erkennungsmodell bevorzugt, wenn Sie einen Aufruf senden, der das PhraseSet enthält.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

DeleteCustomClass

rpc DeleteCustomClass(DeleteCustomClassRequest) returns (Empty)

Benutzerdefinierten Kurs löschen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

DeletePhraseSet

rpc DeletePhraseSet(DeletePhraseSetRequest) returns (Empty)

Wortgruppensatz löschen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

GetCustomClass

rpc GetCustomClass(GetCustomClassRequest) returns (CustomClass)

Benutzerdefinierte Klasse erstellen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

GetPhraseSet

rpc GetPhraseSet(GetPhraseSetRequest) returns (PhraseSet)

Wortgruppensatz abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

ListCustomClasses

rpc ListCustomClasses(ListCustomClassesRequest) returns (ListCustomClassesResponse)

Benutzerdefinierte Klassen auflisten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

ListPhraseSet

rpc ListPhraseSet(ListPhraseSetRequest) returns (ListPhraseSetResponse)

Wortgruppensätze auflisten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

UpdateCustomClass

rpc UpdateCustomClass(UpdateCustomClassRequest) returns (CustomClass)

Benutzerdefinierten Kurs aktualisieren

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

UpdatePhraseSet

rpc UpdatePhraseSet(UpdatePhraseSetRequest) returns (PhraseSet)

Wortgruppensatz aktualisieren

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

Speech

Dienst, in den die Google Cloud Speech API implementiert ist.

LongRunningRecognize

rpc LongRunningRecognize(LongRunningRecognizeRequest) returns (Operation)

Führt asynchrone Spracherkennung durch: Die Ergebnisse erhalten Sie über die Schnittstelle google.longrunning.Operations. Gibt entweder ein Operation.error- oder ein Operation.response-Element zurück, das eine LongRunningRecognizeResponse-Nachricht enthält. Weitere Informationen zur asynchronen Spracherkennung finden Sie in der Anleitung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

Erkennen

rpc Recognize(RecognizeRequest) returns (RecognizeResponse)

Führt synchrone Spracherkennung durch: Die Ergebnisse erhalten Sie, wenn alle Audiodaten gesendet und verarbeitet wurden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

StreamingRecognize

rpc StreamingRecognize(StreamingRecognizeRequest) returns (StreamingRecognizeResponse)

Führt bidirektionale Streamingspracherkennung durch: Die Ergebnisse erhalten Sie, während die Audiodaten gesendet werden. Diese Methode ist nur über die gRPC API (nicht über die REST API) verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.

CreateCustomClassRequest

Nachricht, die vom Client für die Methode CreateCustomClass gesendet wird.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese benutzerdefinierte Klasse erstellt wird. Format:

projects/{project}/locations/{location}/customClasses

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • speech.customClasses.create
custom_class_id

string

Erforderlich. Die für die benutzerdefinierte Klasse zu verwendende ID, die als letzte Komponente des Ressourcennamens der benutzerdefinierten Klasse verwendet wird.

Dieser Wert sollte auf Buchstaben, Ziffern und Bindestriche beschränkt sein. Das erste Zeichen muss ein Buchstabe und das letzte ein Buchstabe oder eine Ziffer sein. Die Länge sollte 4 bis 63 Zeichen betragen.

custom_class

CustomClass

Erforderlich. Die benutzerdefinierte Klasse, die erstellt werden soll.

CreatePhraseSetRequest

Nachricht, die vom Client für die Methode CreatePhraseSet gesendet wird.

Felder
parent

string

Erforderlich. Die übergeordnete Ressource, in der diese Gruppe von Begriffen erstellt wird. Format:

projects/{project}/locations/{location}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • speech.phraseSets.create
phrase_set_id

string

Erforderlich. Die für die Wortgruppe zu verwendende ID, die als letzte Komponente des Ressourcennamens der Wortgruppe verwendet wird.

Dieser Wert sollte auf Buchstaben, Ziffern und Bindestriche beschränkt sein. Das erste Zeichen muss ein Buchstabe und das letzte ein Buchstabe oder eine Ziffer sein. Die Länge sollte 4 bis 63 Zeichen betragen.

phrase_set

PhraseSet

Erforderlich. Der zu erstellende Wortgruppensatz.

CustomClass

Eine Reihe von Wörtern oder Wortgruppen, die ein gängiges Konzept darstellen, das wahrscheinlich in Ihrem Audio vorkommt, z. B. eine Liste von Namen von Passagierschiffen. CustomClass-Elemente können in Platzhalter eingesetzt werden, die Sie in PhraseSet-Formulierungen festlegen.

Felder
name

string

Der Ressourcenname der benutzerdefinierten Klasse.

custom_class_id

string

Wenn diese benutzerdefinierte Klasse eine Ressource ist, ist „custom_class_id“ die Ressourcen-ID der CustomClass. Groß- und Kleinschreibung wird berücksichtigt.

items[]

ClassItem

Eine Sammlung von Klassenelementen.

kms_key_name

string

Nur Ausgabe. Der KMS-Schlüsselname, mit dem der Inhalt des ClassItem verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kms_key_version_name

string

Nur Ausgabe. Der Name der KMS-Schlüsselversion, mit der der Inhalt des ClassItem verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für die CustomClass. Dieses Feld wird nicht verwendet.

display_name

string

Nur Ausgabe. Vom Nutzer festlegbarer, für Menschen lesbarer Name für die CustomClass. Darf höchstens 63 Zeichen lang sein. Dieses Feld wird nicht verwendet.

state

State

Nur Ausgabe. Der Lebenszyklusstatus der CustomClass. Dieses Feld wird nicht verwendet.

delete_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Löschen dieser Ressource angefordert wurde. Dieses Feld wird nicht verwendet.

expire_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem diese Ressource gelöscht wird. Dieses Feld wird nicht verwendet.

annotations

map<string, string>

Nur Ausgabe. Ermöglicht Nutzern das Speichern kleiner Mengen beliebiger Daten. Sowohl der Schlüssel als auch der Wert dürfen jeweils maximal 63 Zeichen lang sein. Maximal 100 Annotationen. Dieses Feld wird nicht verwendet.

etag

string

Nur Ausgabe. Diese Prüfsumme wird vom Server auf Grundlage des Werts anderer Felder berechnet. Kann bei Aktualisierungs-, Wiederherstellungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. Dieses Feld wird nicht verwendet.

reconciling

bool

Nur Ausgabe. Gibt an, ob diese CustomClass gerade aktualisiert wird. Dieses Feld wird nicht verwendet.

ClassItem

Ein Element der Klasse.

Felder
value

string

Der Wert des Klassenartikels.

Bundesland

Eine Reihe von Status, die den Lebenszyklus einer CustomClass definieren.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand. Dies wird nur verwendet, um nicht festgelegte Werte zu unterscheiden.
ACTIVE Der normale und der aktive Status.
DELETED Diese CustomClass wurde gelöscht.

DeleteCustomClassRequest

Nachricht, die vom Client für die Methode DeleteCustomClass gesendet wird.

Felder
name

string

Erforderlich. Der Name der benutzerdefinierten Klasse, die gelöscht werden soll. Format:

projects/{project}/locations/{location}/customClasses/{custom_class}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • speech.customClasses.delete

DeletePhraseSetRequest

Nachricht, die vom Client für die Methode DeletePhraseSet gesendet wird.

Felder
name

string

Erforderlich. Der Name des zu löschenden Satz-Sets. Format:

projects/{project}/locations/{location}/phraseSets/{phrase_set}

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • speech.phraseSets.delete

GetCustomClassRequest

Nachricht, die vom Client für die Methode GetCustomClass gesendet wird.

Felder
name

string

Erforderlich. Der Name der benutzerdefinierten Klasse, die abgerufen werden soll. Format:

projects/{project}/locations/{location}/customClasses/{custom_class}

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • speech.customClasses.get

GetPhraseSetRequest

Nachricht, die vom Client für die Methode GetPhraseSet gesendet wird.

Felder
name

string

Erforderlich. Der Name des abzurufenden Wortgruppensatzes. Format:

projects/{project}/locations/{location}/phraseSets/{phrase_set}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • speech.phraseSets.get

ListCustomClassesRequest

Nachricht, die vom Client für die Methode ListCustomClasses gesendet wird.

Felder
parent

string

Erforderlich. Das übergeordnete Element, das diese Sammlung von benutzerdefinierten Klassen besitzt. Format:

projects/{project}/locations/{location}/customClasses

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • speech.customClasses.list
page_size

int32

Die maximale Anzahl der zurückzugebenden benutzerdefinierten Klassen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Falls nicht angegeben, werden maximal 50 benutzerdefinierte Klassen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Ein Seitentoken, das von einem vorherigen ListCustomClass-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListCustomClass bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListCustomClassesResponse

Nachricht, die von der Methode ListCustomClasses an den Client zurückgegeben wird.

Felder
custom_classes[]

CustomClass

Die benutzerdefinierten Klassen.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

ListPhraseSetRequest

Nachricht, die vom Client für die Methode ListPhraseSet gesendet wird.

Felder
parent

string

Erforderlich. Das übergeordnete Element, das diese Sammlung von Wortgruppen-Sets besitzt. Format:

projects/{project}/locations/{location}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • speech.phraseSets.list
page_size

int32

Die maximale Anzahl der zurückzugebenden Wortgruppen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Phrasengruppen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

page_token

string

Ein Seitentoken, das von einem vorherigen ListPhraseSet-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListPhraseSet bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListPhraseSetResponse

Nachricht, die von der Methode ListPhraseSet an den Client zurückgegeben wird.

Felder
phrase_sets[]

PhraseSet

Der Wortgruppensatz.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LongRunningRecognizeMetadata

Beschreibt den Fortschritt eines LongRunningRecognize-Aufrufs mit langer Ausführungszeit. Dies ist im Feld metadata von Operation enthalten, das durch den Aufruf GetOperation des google::longrunning::Operations-Dienstes zurückgegeben wird.

Felder
progress_percent

int32

Ungefährer Prozentsatz der bisher verarbeiteten Audiodaten. Liegt bei 100, wenn die Audiodaten vollständig verarbeitet wurden und die Ergebnisse verfügbar sind.

start_time

Timestamp

Zeitpunkt des Empfangs der Anfrage.

last_update_time

Timestamp

Zeitpunkt der letzten Aktualisierung bei der Verarbeitung.

uri

string

Nur Ausgabe. Der URI der Audio-Datei, die transkribiert wird. Leer, wenn der Audioinhalt als Byte-Inhalt gesendet wurde.

output_config

TranscriptOutputConfig

Nur Ausgabe. Eine Kopie von TranscriptOutputConfig, falls diese in der Anfrage festgelegt wurde.

LongRunningRecognizeRequest

Die Nachricht auf oberster Ebene, die vom Client an die Methode LongRunningRecognize gesendet wird.

Felder
config

RecognitionConfig

Erforderlich. Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung.

audio

RecognitionAudio

Erforderlich. Die zu erkennenden Audiodaten.

output_config

TranscriptOutputConfig

Optional. Gibt ein optionales Ziel für die Erkennungsergebnisse an.

LongRunningRecognizeResponse

Die einzige Nachricht, die von der Methode LongRunningRecognize an den Client zurückgegeben wird. Sie enthält das Ergebnis als null oder mehr aufeinanderfolgende SpeechRecognitionResult-Nachrichten. Dies ist im Feld result.response von Operation enthalten, das durch den Aufruf GetOperation des google::longrunning::Operations-Dienstes zurückgegeben wird.

Felder
results[]

SpeechRecognitionResult

Sequenzielle Liste der Transkriptionsergebnisse, die den sequenziellen Teilen einer Audiodatei entsprechen.

total_billed_time

Duration

Wenn verfügbar, die abgerechneten Audiosekunden für die entsprechende Anfrage.

output_config

TranscriptOutputConfig

Die ursprüngliche Ausgabekonfiguration, falls in der Anfrage vorhanden.

output_error

Status

Wenn die Transkriptausgabe fehlschlägt, enthält dieses Feld den entsprechenden Fehler.

speech_adaptation_info

SpeechAdaptationInfo

Liefert Informationen zum Verhalten der Sprachanpassung in der Antwort

request_id

int64

Die ID, die der Anfrage zugeordnet ist. Dies ist eine eindeutige ID, die nur für die jeweilige Anfrage gilt.

PhraseSet

Liefert dem Spracherkennungsmodul "Hinweise" für bestimmte Wörter und Wendungen, die bei den Ergebnissen zu bevorzugen sind.

Felder
name

string

Der Ressourcenname des Wortgruppensatzes.

phrases[]

Phrase

Eine Liste mit Wörtern und Wortgruppen.

boost

float

Hinweis-Boost Ein positiver Wert erhöht die Wahrscheinlichkeit, dass eine bestimmte Wortgruppe gegenüber anderen ähnlich klingenden Wortgruppen erkannt wird. Je höher der Boost, desto höher ist auch die Wahrscheinlichkeit einer fälschlichen Erkennung. Negative Boost-Werte entsprechen der Anti-Bias-Funktion. Die Funktion zur Vermeidung von Bias ist nicht aktiviert. Der negative Boost wird daher einfach ignoriert. boost kann zwar eine Vielzahl positiver Werte annehmen, für die meisten Anwendungsfälle sind jedoch Werte zwischen 0 (ausschließlich) und 20 am besten geeignet. Wir empfehlen, den optimalen Wert für Ihren Anwendungsfall mithilfe einer binären Suche zu ermitteln und Ihren Anfragen sowohl Begriffe mit als auch ohne Steigerung hinzuzufügen.

kms_key_name

string

Nur Ausgabe. Der KMS-Schlüsselname, mit dem der Inhalt des PhraseSets verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kms_key_version_name

string

Nur Ausgabe. Der Name der KMS-Schlüsselversion, mit der der Inhalt des PhraseSets verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für das PhraseSet. Dieses Feld wird nicht verwendet.

display_name

string

Nur Ausgabe. Vom Nutzer festlegbarer, für Menschen lesbarer Name für den PhraseSet. Darf höchstens 63 Zeichen lang sein. Dieses Feld wird nicht verwendet.

state

State

Nur Ausgabe. Der Lebenszyklusstatus der CustomClass. Dieses Feld wird nicht verwendet.

delete_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Löschen dieser Ressource angefordert wurde. Dieses Feld wird nicht verwendet.

expire_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem diese Ressource gelöscht wird. Dieses Feld wird nicht verwendet.

annotations

map<string, string>

Nur Ausgabe. Ermöglicht Nutzern das Speichern kleiner Mengen beliebiger Daten. Sowohl der Schlüssel als auch der Wert dürfen jeweils maximal 63 Zeichen lang sein. Maximal 100 Annotationen. Dieses Feld wird nicht verwendet.

etag

string

Nur Ausgabe. Diese Prüfsumme wird vom Server auf Grundlage des Werts anderer Felder berechnet. Kann bei Aktualisierungs-, Wiederherstellungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. Dieses Feld wird nicht verwendet.

reconciling

bool

Nur Ausgabe. Gibt an, ob dieses PhraseSet gerade aktualisiert wird. Dieses Feld wird nicht verwendet.

Wortgruppe

Eine Liste von Strings, die Wörter und Wortgruppen "Hinweise" enthalten, damit die Spracherkennung sie mit größerer Wahrscheinlichkeit erkennt. Kann zur Verbesserung der Genauigkeit für bestimmte Wörter und Wendungen verwendet werden, z. B. wenn der Nutzer bestimmte Befehle häufig spricht. Lässt sich ebenfalls verwenden, um weitere Wörter zum Vokabular des Erkennungsmoduls hinzuzufügen. Siehe Nutzungsbeschränkungen.

Listenelemente können auch vordefinierte oder benutzerdefinierte Klassen mit Wortgruppen enthalten, die gängige Konzepte in natürlicher Sprache darstellen. Anstatt beispielsweise für jeden Monat des Jahres einen Hinweis auf einen Ausdruck zu geben (z. B. „Ich wurde im Januar geboren“, „Ich wurde im Februar geboren“ usw.), können Sie die vordefinierte Klasse $MONTH verwenden. Dadurch wird die Wahrscheinlichkeit erhöht, dass Audioinhalte, in denen Monate vorkommen (z. B. „Ich wurde im $month geboren“), richtig transkribiert werden. Wenn Sie auf vordefinierte Klassen verweisen möchten, verwenden Sie das Symbol der Klasse mit dem Präfix $, z.B. $MONTH. Wenn Sie auf benutzerdefinierte Klassen verweisen möchten, die inline in der Anfrage definiert wurden, legen Sie custom_class_id der Klasse auf einen String fest, der für alle Klassenressourcen und Inline-Klassen eindeutig ist. Verwenden Sie dann die ID der Klasse, die in ${...} eingeschlossen ist, z.B. „${my-months}“. Wenn Sie auf benutzerdefinierte Klassenressourcen verweisen möchten, verwenden Sie die ID der Klasse, die in ${} eingeschlossen ist, z.B. ${my-months}.

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Felder
value

string

Die Wortgruppe selbst.

boost

float

Hinweis-Boost Überschreibt die Optimierung, die auf Wortgruppensatzebene festgelegt ist. Ein positiver Wert erhöht die Wahrscheinlichkeit, dass eine bestimmte Wortgruppe gegenüber anderen ähnlich klingenden Wortgruppen erkannt wird. Je höher der Boost, desto höher ist auch die Wahrscheinlichkeit einer fälschlichen Erkennung. Negatives Boosting wird einfach ignoriert. Für boost kann eine Vielzahl positiver Werte verwendet werden. In den meisten Anwendungsfällen sind jedoch Werte zwischen 0 und 20 am besten geeignet. Wir empfehlen, den optimalen Wert für Ihren Anwendungsfall mithilfe einer binären Suche zu ermitteln und Ihren Anfragen sowohl Begriffe mit als auch ohne Steigerung hinzuzufügen.

Bundesland

Eine Reihe von Status, die den Lebenszyklus einer CustomClass definieren.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand. Dies wird nur verwendet, um nicht festgelegte Werte zu unterscheiden.
ACTIVE Der normale und der aktive Status.
DELETED Diese CustomClass wurde gelöscht.

RecognitionAudio

Enthält Audiodaten in der in RecognitionConfig angegebenen Codierung. Es muss entweder content oder uri angegeben werden. Wenn Sie beide oder keine Werte angeben, wird google.rpc.Code.INVALID_ARGUMENT zurückgegeben. Weitere Informationen

Felder
Union-Feld audio_source. Die Audioquelle, bei der es sich um Inline-Content oder einen Google Cloud Storage-URI handelt. Für audio_source ist nur einer der folgenden Werte zulässig:
content

bytes

Die in RecognitionConfig angegebenen Audiodatenbyte. Hinweis: Wie bei allen bytes-Feldern verwenden auch Protokollpuffer eine reine Binärdarstellung, während JSON-Darstellungen Base64 verwenden.

uri

string

URI, der auf eine Datei verweist, die Audiodatenbyte enthält, wie in RecognitionConfig angegeben. Die Datei darf nicht komprimiert sein (z. B. gzip). Derzeit werden nur Google Cloud Storage-URIs unterstützt, die im folgenden Format angegeben werden müssen: gs://bucket_name/object_name (andere URI-Formate geben google.rpc.Code.INVALID_ARGUMENT zurück). Weitere Informationen finden Sie unter Anforderungs-URIs.

RecognitionConfig

Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung.

Felder
encoding

AudioEncoding

Codierung von Audiodaten, die in allen RecognitionAudio-Nachrichten gesendet werden. Dieses Feld ist für Audiodateien vom Typ FLAC und WAV optional und für alle anderen Audioformate erforderlich. Weitere Informationen finden Sie unter AudioEncoding.

sample_rate_hertz

int32

Sampling-Rate der in allen RecognitionAudio-Nachrichten gesendeten Audiodaten in Host. Gültige Werte sind: 8.000-48.000. 16.000 ist optimal. Stellen Sie die Abtastrate der Audioquelle auf 16.000 Hz ein, um die besten Ergebnisse zu erzielen. Falls dies nicht möglich ist, verwenden Sie die native Abtastrate der Audioquelle (anstatt eine erneute Abtastung durchzuführen). Dieses Feld ist für FLAC- und WAV-Audiodateien optional, aber für alle anderen Audioformate erforderlich. Weitere Informationen finden Sie unter AudioEncoding.

audio_channel_count

int32

Die Anzahl der Kanäle in den Audioeingabedaten. Legen Sie dies NUR für die MEHRKANAL-Erkennung fest. Gültige Werte für LINEAR16, OGG_OPUS und FLAC sind 1 bis 8. Als Wert für MULAW, AMR, AMR_WB und SPEEX_WITH_HEADER_BYTE ist nur 1 gültig. Wird der Wert auf 0 gesetzt oder weggelassen, wird standardmäßig ein Kanal (Mono) verwendet. Hinweis: Standardmäßig wird nur der erste Kanal erkannt. Wenn Sie eine unabhängige Erkennung für jeden Kanal ausführen möchten, setzen Sie enable_separate_recognition_per_channel auf „true“.

enable_separate_recognition_per_channel

bool

Dies muss explizit auf true und audio_channel_count > 1 festgelegt werden, damit jeder Kanal separat erkannt wird. Das Erkennungsergebnis enthält das Feld channel_tag, das darüber Aufschluss gibt, zu welchem Kanal das jeweilige Ergebnis gehört. Wenn es nicht auf "true" gesetzt ist, wird nur der erste Kanal erkannt. Die Anfrage wird kumulativ für alle erkannten Kanäle abgerechnet: audio_channel_count multipliziert mit der Länge der Audioinhalte.

language_code

string

Erforderlich. Die Sprache der übermittelten Audiodaten, angegeben als BCP-47-Sprachcode. Beispiel: "en-US". Unter Sprachunterstützung finden Sie eine Liste der aktuell unterstützten Sprachcodes.

alternative_language_codes[]

string

Eine Liste mit bis zu drei zusätzlichen BCP-47-Sprachcodes, in der mögliche alternative Sprachen der bereitgestellten Audiodaten aufgeführt sind. Unter Sprachunterstützung finden Sie eine Liste der aktuell unterstützten Sprachcodes. Wenn alternative Sprachen aufgelistet sind, enthält das Erkennungsergebnis die Erkennung in der erkannten Sprache, die am wahrscheinlichsten ist, einschließlich des Hauptsprachencodes. Das Erkennungsergebnis enthält den Sprachcode der Sprache, die in dem Audio erkannt wird. Hinweis: Diese Funktion wird nur für Anwendungsfälle der Sprachsteuerung und der Sprachsuche unterstützt, und die Leistung kann für andere Anwendungsfälle variieren (z. B. Transkription von Telefonanrufen).

max_alternatives

int32

Maximale Anzahl der zurückzugebenden Erkennungshypothesen. Genauer gesagt die maximale Anzahl von SpeechRecognitionAlternative-Nachrichten in jedem SpeechRecognitionResult. Der Server gibt möglicherweise weniger als max_alternatives zurück. Gültige Werte sind 0–30. Bei einem Wert von 0 oder 1 wird maximal ein Ergebnis zurückgegeben. Bei Auslassung wird ein Maximum von 1 zurückgegeben.

profanity_filter

bool

Wenn der Wert auf true gesetzt ist, versucht der Server, vulgäre Sprache herauszufiltern, und ersetzt in den gefilterten Wörtern alle Buchstaben mit Ausnahme des Anfangsbuchstabens durch Sternchen, z.B. „S******“. Wenn diese Option auf false gesetzt oder weggelassen wird, werden Obszönitäten nicht herausgefiltert.

adaptation

SpeechAdaptation

Durch die Konfiguration der Sprachanpassung wird die Genauigkeit der Spracherkennung verbessert. Weitere Informationen finden Sie in der Dokumentation zur Sprachanpassung. Wenn die Sprachanpassung festgelegt ist, wird das Feld speech_contexts überschrieben.

transcript_normalization

TranscriptNormalization

Optional. Mit der Transkriptnormalisierung können Sie automatisch bestimmte Teile des Transkripts durch von Ihnen ausgewählte Formulierungen ersetzen lassen. Bei StreamingRecognize gilt diese Normalisierung nur für stabile Teiltranskripte (Stabilität > 0, 8) und endgültige Transkripte.

speech_contexts[]

SpeechContext

Array von SpeechContext. Zur Bereitstellung von Kontext zur Unterstützung der Spracherkennung. Weitere Informationen finden Sie unter Sprachanpassung.

enable_word_time_offsets

bool

Bei true enthält das beste Ergebnis eine Liste von Wörtern sowie die Zeitverschiebungen (Zeitstempel) zu den Anfangs- und Endzeiten dieser Wörter. Bei false werden keine Informationen zum zeitlichen Versatz auf Wortebene zurückgegeben. Der Standardwert ist false.

enable_word_confidence

bool

Bei true enthält das beste Ergebnis eine Liste von Wörtern sowie den Konfidenzwert für diese Wörter. Bei false werden keine Konfidenzinformationen auf Wortebene zurückgegeben. Der Standardwert ist false.

enable_automatic_punctuation

bool

Wenn „true“, werden den Hypothesen für das Erkennungsergebnis Satzzeichen hinzugefügt. Diese Funktion steht nur für ausgewählte Sprachen zur Verfügung. Wird sie für andere Sprachen festgelegt, hat dies keine Auswirkungen. Mit dem Standardwert "false" werden den Ergebnishypothesen keine Satzzeichen hinzugefügt.

enable_spoken_punctuation

BoolValue

Das Verhalten der gesprochenen Satzzeichen für den Anruf. Wenn nicht festgelegt, wird das Standardverhalten basierend auf dem ausgewählten Modell verwendet. Bei „command_and_search“ werden gesprochene Satzzeichen standardmäßig aktiviert. Wenn „true“, werden gesprochene Satzzeichen in der Anfrage durch die entsprechenden Symbole ersetzt. Beispiel: „Wie geht es dir Fragezeichen“ wird zu „Wie geht es dir?“. Weitere Informationen finden Sie unter https://cloud.google.com/speech-to-text/docs/spoken-punctuation. Bei „false“ werden gesprochene Satzzeichen nicht ersetzt.

enable_spoken_emojis

BoolValue

Das Verhalten der gesprochenen Emojis für den Anruf. Wenn nicht festgelegt, wird das Standardverhalten basierend auf dem ausgewählten Modell verwendet. Wenn „true“, wird für die Anfrage die Formatierung von gesprochenen Emojis hinzugefügt. Dadurch werden gesprochene Emojis im endgültigen Transkript durch die entsprechenden Unicode-Symbole ersetzt. Bei „false“ werden gesprochene Emojis nicht ersetzt.

enable_speaker_diarization
(deprecated)

bool

Wenn „true“, wird die Sprechererkennung für jedes erkannte Wort in der besten Alternative des Erkennungsergebnisses mithilfe eines in WordInfo bereitgestellten „speaker_label“ aktiviert. Hinweis: Verwenden Sie stattdessen diarization_config.

diarization_speaker_count
(deprecated)

int32

Wenn festgelegt, gibt dies die geschätzte Anzahl der Sprecher in der Unterhaltung an. Die Standardeinstellung ist „2“. Wird ignoriert, sofern „enable_speaker_diarization“ nicht auf „true“ gesetzt ist. Hinweis: Verwenden Sie stattdessen diarization_config.

diarization_config

SpeakerDiarizationConfig

Konfiguration zum Aktivieren der Sprecherbestimmung und Festlegen zusätzlicher Parameter, um die Bestimmung besser an Ihre Anwendung anzupassen. Hinweis: Wenn diese Option aktiviert ist, senden wir alle Wörter vom Beginn des Audios für die beste Alternative in jeder nachfolgenden STREAMING-Antwort. Damit sollen die Sprechertags verbessert werden, da unsere Modelle lernen, die Sprecher im Gespräch im Laufe der Zeit zu identifizieren. Bei Nicht-Streaming-Anfragen werden die Ergebnisse der Sprecherbestimmung nur in der besten Alternative des FINAL SpeechRecognitionResult bereitgestellt.

metadata

RecognitionMetadata

Metadaten zu dieser Anfrage.

model

string

Auswahl des Modells für die jeweilige Anfrage. Wählen Sie das für Ihre Domain am besten geeignete Modell aus, um die besten Ergebnisse zu erzielen. Wird kein Modell explizit angegeben, wird ein Modell basierend auf den Parametern in der RecognitionConfig automatisch ausgewählt.

Modell Beschreibung

latest_long

Optimal für lange Inhalte wie Medien oder Unterhaltungen.

latest_short

Optimal für kurzformatige Inhalte wie Befehle oder gerichtete Sprache in einer einzigen Aufnahme.

command_and_search

Optimal für kurze Abfragen wie Sprachbefehle oder Sprachsuche

phone_call

Am besten geeignet für Audiodaten, die aus einem Telefonanruf stammen (normalerweise mit einer Abtastrate von 8 kHz aufgezeichnet)

video

Optimal für Audiodaten, die aus einem Video stammen oder mehrere Sprecher enthalten. Idealerweise werden die Audiodaten mit einer Abtastrate von 16 kHz oder mehr aufgezeichnet. Dies ist ein Premium-Modell, das mehr kostet als der Standardsatz.

default

Am besten geeignet für Audiodaten, die zu keinem spezifischen Audiomodell gehören, beispielsweise langformatiger Audioinhalt. Idealerweise sollten dies High-Fidelity-Audiodaten sein, die mit einer Abtastrate von 16 kHz oder mehr aufgezeichnet werden.

medical_conversation

Optimal für Audiodaten, die aus einer Unterhaltung zwischen einem Gesundheitsdienstleister und einem Patienten stammen.

medical_dictation

Optimal für Audiodaten, die aus Diktatnotizen eines medizinischen Dienstleisters stammen.

use_enhanced

bool

Auf „true“ setzen, um ein optimiertes Modell für die Spracherkennung zu verwenden. Wenn use_enhanced auf „true“ gesetzt ist und das Feld model nicht festgelegt ist, wird ein geeignetes erweitertes Modell ausgewählt, sofern ein erweitertes Modell für das Audio vorhanden ist.

Wenn use_enhanced „true“ ist und keine erweiterte Version des angegebenen Modells vorhanden ist, wird die Sprache mit der Standardversion des angegebenen Modells erkannt.

AudioEncoding

Die Codierung der Audiodaten, die in der Anfrage gesendet wurden.

Bei allen Codierungen werden nur Audiodaten mit einem Kanal unterstützt (Mono), sofern die Felder audio_channel_count und enable_separate_recognition_per_channel nicht festgelegt sind.

Für optimale Ergebnisse sollte die Audioquelle mit einer verlustfreien Codierung (FLAC oder LINEAR16) erfasst und übertragen werden. Die Genauigkeit der Spracherkennung kann reduziert werden, wenn verlustbehaftete Codecs zum Erfassen oder Übertragen von Audio verwendet werden, insbesondere wenn Hintergrundgeräusche vorhanden sind. Zu verlustbehafteten Codecs gehören MULAW, AMR, AMR_WB, OGG_OPUS, SPEEX_WITH_HEADER_BYTE, MP3 und WEBM_OPUS.

Die Audiodateiformate FLAC und WAV enthalten einen Header, der den enthaltenen Audioinhalt beschreibt. Sie können die Erkennung für WAV-Dateien anfordern, die mit LINEAR16 oder MULAW codierte Audiodaten enthalten. Wenn Sie in Ihrer Anfrage das Audiodateiformat FLAC oder WAV senden, müssen Sie kein AudioEncoding festlege. Das Audiocodierungsformat wird aus dem Dateiheader bestimmt. Wenn Sie beim Senden von FLAC- oder WAV-Audiodaten eine AudioEncoding angeben, muss die Codierungskonfiguration mit der im Audioheader beschriebenen Codierung übereinstimmen. Andernfalls gibt die Anfrage den Fehlercode google.rpc.Code.INVALID_ARGUMENT zurück.

Enums
ENCODING_UNSPECIFIED Nicht angegeben.
LINEAR16 Unkomprimierte 16-Bit-Little-Endian-Samples mit Vorzeichen (Lineare PCM).
FLAC Als Codierung wird FLAC (Free Lossless Audio Codec) empfohlen, da sie verlustfrei arbeitet, sodass die Erkennung nicht beeinträchtigt wird, und nur etwa halb so viel Bandbreite wie LINEAR16 benötigt. Die Streamcodierung FLAC unterstützt 16-Bit- und 24-Bit-Samples, jedoch werden nicht alle Felder in STREAMINFO unterstützt.
MULAW 8-Bit-Samples zur Kompandierung von 14-Bit-Audiosamples mit G.711 PCMU/mu-law.
AMR Adaptiver Codec für Multi-Rate-Schmalband. sample_rate_hertz muss 8.000 betragen.
AMR_WB Adaptiver Codec für Multi-Rate-Breitband. sample_rate_hertz muss 16.000 betragen.
OGG_OPUS Opuscodierte Audioframes im Ogg-Container (OggOpus). Die sample_rate_hertz muss 8.000, 12.000, 16.000, 24.000 oder 48.000 betragen.
SPEEX_WITH_HEADER_BYTE Die Verwendung verlustbehafteter Codierungen wird zwar nicht empfohlen, aber wenn eine Codierung mit sehr niedriger Bitrate erforderlich ist, ist OGG_OPUS gegenüber einer Speex-Codierung klar vorzuziehen. Die von der Cloud Speech API unterstützte Speex-Codierung hat in jedem Block ein Header-Byte, wie im MIME-Typ audio/x-speex-with-header-byte. Es handelt sich um eine Variante der in RFC 5574 definierten RTP Speex-Codierung. Der Stream besteht aus einer Abfolge von Blöcken, ein Block pro RTP-Paket. Jeder Block beginnt mit einem Byte, aus dem die Länge des Blocks in Byte hervorgeht, gefolgt von einem oder mehreren Frames an Speex-Daten, die gemäß RFC 5574 auf eine ganzzahlige Anzahl von Byte (Oktetten) aufgefüllt werden. Mit anderen Worten, jeder RTP-Header wird durch ein einzelnes Byte ersetzt, aus dem die Blocklänge hervorgeht. Es wird ausschließlich Speex-Breitband unterstützt. sample_rate_hertz muss 16.000 sein.
MP3 MP3-Audio. Die MP3-Codierung ist ein Beta-Feature, das nur in v1p1beta1 verfügbar ist. Unterstützt alle gängigen MP3-Bitraten (von 32 bis 320 kbit/s). Bei Verwendung dieser Codierung muss sample_rate_hertz mit der Abtastrate der verwendeten Datei übereinstimmen.
WEBM_OPUS Opus-codierte Audioframes in einem WebM-Container (WebM). sample_rate_hertz muss 8.000, 12.000, 16.000, 24.000 oder 48.000 betragen.
ALAW 8-Bit-Samples zur Kompandierung von 13-Bit-Audiosamples mit G.711 PCMU/a-law.

RecognitionMetadata

Beschreibung der zu erkennenden Audiodaten.

Felder
interaction_type

InteractionType

Der Anwendungsfall, der die zu erkennenden Audioinhalte am genauesten beschreibt.

industry_naics_code_of_audio

uint32

Die vertikale Branche, die auf diese Spracherkennungsanfrage am genauesten zutrifft. Dies ist ein nützlicher Hinweis auf das Thema, um das es in der Audiodatei geht. Geben Sie die vertikale Branche mit dem sechsstelligen NAICS-Code an, siehe https://www.naics.com/search/.

microphone_distance

MicrophoneDistance

Der Audiotyp, mit dem sich die zu erkennende Audiodatei am besten beschreiben lässt.

original_media_type

OriginalMediaType

Das Medium, auf dem die Sprache ursprünglich aufgezeichnet wurde.

recording_device_type

RecordingDeviceType

Die Art von Gerät, mit dem die Sprache aufgezeichnet wurde.

recording_device_name

string

Das für die Aufzeichnung verwendete Gerät. Beispiele: "Nexus 5X", "Polycom SoundStation IP 6000", "POTS", "VoIP" oder "Cardioid Microphone".

original_mime_type

string

MIME-Typ der ursprünglichen Audiodatei. Beispiele: audio/m4a, audio/x-alaw-basic, audio/mp3, audio/3gpp. Eine Liste der möglichen Audio-MIME-Typen finden Sie unter http://www.iana.org/assignments/media-types/media-types.xhtml#audio.

obfuscated_id
(deprecated)

int64

Die verschleierte (dem Datenschutz unterliegende) ID des Nutzers. Mit dieser wird die Anzahl der einzelnen Nutzer bestimmt, die den Dienst verwenden.

audio_topic

string

Beschreibung des Inhalts, z. B. "Aufnahmen von Anhörungen des Supreme Courts aus dem Jahr 2012".

InteractionType

Kategorien von Anwendungsfällen, mit denen sich die Anfrage wegen Spracherkennung beschreiben lässt.

Enums
INTERACTION_TYPE_UNSPECIFIED Der Anwendungsfall ist entweder unbekannt oder entspricht nicht einem der anderen unten angegebenen Werte.
DISCUSSION Mehrere Personen in einer Unterhaltung oder Diskussion. Zum Beispiel bei einer Sitzung mit mindestens zwei aktiven Teilnehmern. In der Regel befinden sich alle Hauptsprecher im selben Raum (wenn nicht, siehe PHONE_CALL).
PRESENTATION Mindestens eine Person, die vor anderen einen Vortrag oder eine Präsentation hält, vorwiegend ohne Unterbrechung.
PHONE_CALL Ein Telefonanruf oder eine Videokonferenz mit mindestens zwei aktiven Teilnehmern, die sich nicht im selben Raum befinden.
VOICEMAIL Eine aufgezeichnete Nachricht, die für eine andere Person bestimmt ist.
PROFESSIONALLY_PRODUCED Professionell produzierte Audioinhalte (z. B. Fernsehsendung, Podcast).
VOICE_COMMAND Transkription von Sprachbefehlen, z. B. zum Steuern eines Geräts.
DICTATION Transkription von Sprache zum Erstellen eines schriftlichen Dokuments, z. B. einer Textnachricht, einer E-Mail oder eines Berichts.

MicrophoneDistance

Aufzählung der Arten von Erfassungseinstellungen zur Beschreibung einer Audiodatei.

Enums
MICROPHONE_DISTANCE_UNSPECIFIED Der Audiotyp ist nicht bekannt.
NEARFIELD Die Audiodaten wurden mit einem Aufnahmegerät in geringem Abstand erfasst. Zum Beispiel Telefon, Diktiergerät oder Handmikrofon. In der Regel befindet sich der Sprecher in einem Abstand von höchstens einem Meter zum Mikrofon.
MIDFIELD Der Sprecher befindet sich in einem Abstand von höchstens drei Metern zum Mikrofon.
FARFIELD Der Sprecher befindet sich in einem Abstand von über drei Metern zum Mikrofon.

OriginalMediaType

Das Medium, auf dem die Sprache ursprünglich aufgezeichnet wurde.

Enums
ORIGINAL_MEDIA_TYPE_UNSPECIFIED Ursprünglicher Medientyp unbekannt.
AUDIO Bei den Sprachdaten handelt es sich um eine Audioaufzeichnung.
VIDEO Die Sprachdaten wurden ursprünglich auf Video aufgezeichnet.

RecordingDeviceType

Die Art von Gerät, mit dem die Sprache aufgezeichnet wurde.

Enums
RECORDING_DEVICE_TYPE_UNSPECIFIED Das Aufnahmegerät ist unbekannt.
SMARTPHONE Die Sprache wurde auf einem Smartphone aufgezeichnet.
PC Die Sprache wurde mit einem PC oder Tablet aufgezeichnet.
PHONE_LINE Die Sprache wurde über eine Telefonleitung aufgezeichnet.
VEHICLE Die Sprache wurde in einem Fahrzeug aufgezeichnet.
OTHER_OUTDOOR_DEVICE Die Sprache wurde im Freien aufgezeichnet.
OTHER_INDOOR_DEVICE Die Sprache wurde in einem geschlossenen Raum aufgenommen.

RecognizeRequest

Die Nachricht auf oberster Ebene, die vom Client an die Methode Recognize gesendet wird.

Felder
config

RecognitionConfig

Erforderlich. Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung.

audio

RecognitionAudio

Erforderlich. Die zu erkennenden Audiodaten.

RecognizeResponse

Die einzige Nachricht, die von der Methode Recognize an den Client zurückgegeben wird. Sie enthält das Ergebnis als null oder mehr aufeinanderfolgende SpeechRecognitionResult-Nachrichten.

Felder
results[]

SpeechRecognitionResult

Sequenzielle Liste der Transkriptionsergebnisse, die den sequenziellen Teilen einer Audiodatei entsprechen.

total_billed_time

Duration

Wenn verfügbar, die abgerechneten Audiosekunden für die entsprechende Anfrage.

speech_adaptation_info

SpeechAdaptationInfo

Liefert Informationen zum Anpassungsverhalten in der Antwort

request_id

int64

Die ID, die der Anfrage zugeordnet ist. Dies ist eine eindeutige ID, die nur für die jeweilige Anfrage gilt.

using_legacy_models

bool

Gibt an, ob in der Anfrage Legacy-ASR-Modelle verwendet wurden (die nicht automatisch auf Conformer-Modelle migriert wurden).

SpeakerDiarizationConfig

Konfiguration zum Aktivieren der Sprecherbestimmung.

Felder
enable_speaker_diarization

bool

Wenn „true“, wird die Sprechererkennung für jedes erkannte Wort in der besten Alternative des Erkennungsergebnisses mithilfe eines in WordInfo bereitgestellten „speaker_label“ aktiviert.

min_speaker_count

int32

Mindestanzahl der Sprecher in der Unterhaltung. Dieser Bereich bietet Ihnen mehr Flexibilität, da das System die richtige Anzahl der Sprecher automatisch bestimmen kann. Wenn nicht festgelegt, beträgt der Standardwert 2.

max_speaker_count

int32

Maximale Anzahl der Sprecher in der Unterhaltung. Dieser Bereich bietet Ihnen mehr Flexibilität, da das System die richtige Anzahl der Sprecher automatisch bestimmen kann. Wenn nicht festgelegt, beträgt der Standardwert 6.

speaker_tag
(deprecated)

int32

Nur Ausgabe. nicht in Verwendung.

SpeechAdaptation

Konfiguration der Sprachanpassung.

Felder
phrase_sets[]

PhraseSet

Eine Sammlung von Wortgruppensätzen. Wenn Sie die Hinweise inline angeben möchten, lassen Sie das Feld name des Satzes leer und füllen Sie die restlichen Felder aus. Für jeden Satz von Wortgruppen kann jede benutzerdefinierte Klasse verwendet werden.

phrase_set_references[]

string

Eine Sammlung von Ressourcennamen für Wortgruppen, die verwendet werden sollen.

custom_classes[]

CustomClass

Eine Sammlung benutzerdefinierter Klassen. Wenn Sie die Klassen inline angeben möchten, lassen Sie das name der Klasse leer und füllen Sie die restlichen Felder aus. Geben Sie der Klasse ein eindeutiges custom_class_id. Verweisen Sie in den Hinweisphrasen über custom_class_id auf die inline definierte Klasse.

abnf_grammar

ABNFGrammar

Die Augmented Backus-Naur Form (ABNF) ist eine standardisierte Grammatiknotation, die aus einer Reihe von Ableitungsregeln besteht. Spezifikationen: https://www.w3.org/TR/speech-grammar

ABNFGrammar

Felder
abnf_strings[]

string

Alle Deklarationen und Regeln einer ABNF-Grammatik, die in mehrere Strings aufgeteilt werden, die am Ende verkettet werden.

SpeechAdaptationInfo

Informationen zur Verwendung der Sprachanpassung in Ergebnissen

Felder
adaptation_timeout

bool

Gibt an, ob beim Anwenden der Sprachanpassung eine Zeitüberschreitung aufgetreten ist. Wenn „true“, hatte die Anpassung keine Auswirkungen auf das Transkript in der Antwort.

timeout_message

string

Wenn festgelegt, wird eine Meldung zurückgegeben, die angibt, welcher Teil der Anfrage zur Sprachanpassung das Zeitlimit überschritten hat.

SpeechContext

Liefert dem Spracherkennungsmodul "Hinweise" für bestimmte Wörter und Wendungen, die bei den Ergebnissen zu bevorzugen sind.

Felder
phrases[]

string

Eine Liste von Strings, die Wörter und Wortgruppen "Hinweise" enthalten, damit die Spracherkennung sie mit größerer Wahrscheinlichkeit erkennt. Kann zur Verbesserung der Genauigkeit für bestimmte Wörter und Wendungen verwendet werden, z. B. wenn der Nutzer bestimmte Befehle häufig spricht. Lässt sich ebenfalls verwenden, um weitere Wörter zum Vokabular des Erkennungsmoduls hinzuzufügen. Siehe Nutzungsbeschränkungen.

Listenelemente können auch auf Klassen für Wortgruppen festgelegt werden, die gängige Konzepte in natürlicher Sprache darstellen. Anstatt beispielsweise für jeden Monat des Jahres Phrasenhinweise anzugeben, erhöht die Verwendung der Klasse $MONTH die Wahrscheinlichkeit, dass Audio mit Monaten korrekt transkribiert wird.

boost

float

Hinweis-Boost Ein positiver Wert erhöht die Wahrscheinlichkeit, dass eine bestimmte Wortgruppe gegenüber anderen ähnlich klingenden Wortgruppen erkannt wird. Je höher der Boost, desto höher ist auch die Wahrscheinlichkeit einer fälschlichen Erkennung. Negative Boost-Werte entsprechen der Anti-Bias-Funktion. Die Funktion zur Vermeidung von Bias ist nicht aktiviert. Der negative Boost wird daher einfach ignoriert. Für boost kann eine Vielzahl positiver Werte verwendet werden. In den meisten Anwendungsfällen sind jedoch Werte zwischen 0 und 20 am besten geeignet. Wir empfehlen, den optimalen Wert für Ihren Anwendungsfall mithilfe einer binären Suche zu ermitteln.

SpeechRecognitionAlternative

Alternative Hypothesen.

Felder
transcript

string

Transkriptionstext mit den vom Nutzer gesprochenen Wörtern In Sprachen, in denen Wörter durch Leerzeichen getrennt werden, kann das Transkript ein vorangestelltes Leerzeichen enthalten, wenn es nicht das erste Ergebnis ist. Sie können die einzelnen Ergebnisse verketten, um das vollständige Transkript ohne Trennzeichen zu erhalten.

confidence

float

Eine Konfidenzschätzung zwischen 0,0 und 1,0. Je höher der Wert ist, desto höher ist die geschätzte Wahrscheinlichkeit, dass die Wörter korrekt erkannt wurden. Dieses Feld wird nur für die beste Alternative eines Nicht-Streaming-Ergebnisses oder eines Streaming-Ergebnisses festgelegt, bei dem is_final=true gilt. Die Genauigkeit dieses Feldes kann nicht garantiert werden und Nutzer sollten sich nicht darauf verlassen, dass es immer zur Verfügung steht. Der Standardwert 0,0 ist ein Sentinel-Wert, der angibt, dass confidence nicht festgelegt wurde.

words[]

WordInfo

Eine Liste von wortspezifischen Informationen zu jedem erkannten Wort. Hinweis: Wenn enable_speaker_diarization zutrifft, werden alle Wörter ab dem Beginn des Audios angezeigt.

SpeechRecognitionResult

Ein Spracherkennungsergebnis, das einem Teil der Audiodaten entspricht.

Felder
alternatives[]

SpeechRecognitionAlternative

Kann eine oder mehrere Erkennungshypothesen enthalten (bis zum Maximum, das in max_alternatives angegeben ist). Diese Alternativen sind nach Genauigkeit geordnet. Die beste (erste) Alternative ist dabei der Einstufung des Erkennungsmoduls zufolge die wahrscheinlichste.

channel_tag

int32

Bei Mehrkanalaudio ist dies die Kanalnummer, die dem erkannten Ergebnis für die Audiodaten aus diesem Kanal entspricht. Bei "audio_channel_count" = N können dessen Ausgabewerte zwischen 1 und N liegen.

result_end_time

Duration

Zeitverschiebung des Endes dieses Ergebnisses relativ zum Beginn des Audios.

language_code

string

Nur Ausgabe. Der Sprachcode BCP-47 der Sprache in diesem Ergebnis. Es wurde erkannt, dass dieser Sprachcode wahrscheinlich in der Audiodatei gesprochen wird.

StreamingRecognitionConfig

Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung.

Felder
config

RecognitionConfig

Erforderlich. Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung.

single_utterance

bool

Wenn false oder nicht angegeben, wird vom Erkennungsmodul eine fortlaufende Erkennung durchgeführt (es wird auf Audiodaten gewartet und sie werden verarbeitet, auch wenn der Nutzer Sprechpausen einlegt) bis der Eingabestream (gRPC API) vom Client geschlossen wird oder das maximale Zeitlimit erreicht ist. Kann mehrere StreamingRecognitionResults zurückgeben, wobei das Flag is_final auf true gesetzt ist.

Bei true erkennt der Erkennungsdienst eine einzelne gesprochene Äußerung. Wird erkannt, dass der Nutzer pausiert oder nicht mehr spricht, gibt er ein END_OF_SINGLE_UTTERANCE-Ereignis zurück und beendet die Erkennung. Es wird maximal ein StreamingRecognitionResult mit dem Flag is_final zurückgegeben, das auf true gesetzt ist.

Das Feld single_utterance kann nur mit bestimmten Modellen verwendet werden. Andernfalls wird ein Fehler ausgegeben. Das Feld model in RecognitionConfig muss auf Folgendes gesetzt sein:

  • command_and_search
  • phone_call UND zusätzliches Feld useEnhanced=true
  • Das Feld model ist nicht definiert. In diesem Fall wählt die API automatisch ein Modell basierend auf allen anderen Parametern aus, die Sie in RecognitionConfig festlegen.
interim_results

bool

Bei true können Zwischenergebnisse (vorläufige Hypothesen) zurückgegeben werden, sobald sie verfügbar sind. Diese Zwischenergebnisse werden mit dem Flag is_final=false gekennzeichnet. Wenn false oder weggelassen, werden nur is_final=true-Ergebnisse zurückgegeben.

enable_voice_activity_events

bool

Wenn true, werden Antworten mit Sprachaktivitätsereignissen zurückgegeben, sobald sie erkannt werden.

voice_activity_timeout

VoiceActivityTimeout

Wenn festgelegt, schließt der Server den Stream automatisch, nachdem die angegebene Dauer seit dem Senden des letzten VOICE_ACTIVITY-Sprachereignisses verstrichen ist. Das Feld voice_activity_events muss ebenfalls auf „true“ gesetzt sein.

VoiceActivityTimeout

Ereignisse, für die ein Zeitlimit für Sprachaktivitäten festgelegt werden kann.

Felder
speech_start_timeout

Duration

Dauer, nach der der Stream beendet wird, wenn keine Sprache erkannt wird.

speech_end_timeout

Duration

Dauer, nach der der Stream beendet wird, nachdem die Sprache beendet wurde.

StreamingRecognitionResult

Ein Erkennungsergebnis für gestreamte Sprache, das einem Teil der Audiodaten entspricht, die aktuell verarbeitet werden.

Felder
alternatives[]

SpeechRecognitionAlternative

Kann eine oder mehrere Erkennungshypothesen enthalten (bis zum Maximum, das in max_alternatives angegeben ist). Diese Alternativen sind nach Genauigkeit geordnet. Die beste (erste) Alternative ist dabei der Einstufung des Erkennungsmoduls zufolge die wahrscheinlichste.

is_final

bool

Bei false stellt StreamingRecognitionResult ein Zwischenergebnis dar, das sich ändern kann. Falls true, ist dies das letzte Mal, dass der Sprachdienst dieses spezifische StreamingRecognitionResult zurückgibt. Das Erkennungsmodul gibt keine weiteren Hypothesen für diesen Teil des Transkripts und die entsprechenden Audiodaten zurück.

stability

float

Eine Schätzung der Wahrscheinlichkeit dafür, dass die Vermutung im Hinblick auf dieses Zwischenergebnis vom Erkennungsmodul nicht geändert wird. Die Werte reichen von 0,0 (vollständig unzuverlässig) bis 1,0 (vollständig zuverlässig). Dieses Feld wird nur für Zwischenergebnisse (is_final=false) bereitgestellt. Der Standardwert 0,0 ist ein Sentinel-Wert, der angibt, dass stability nicht festgelegt wurde.

result_end_time

Duration

Zeitverschiebung des Endes dieses Ergebnisses relativ zum Beginn des Audios.

channel_tag

int32

Bei Mehrkanalaudio ist dies die Kanalnummer, die dem erkannten Ergebnis für die Audiodaten aus diesem Kanal entspricht. Bei "audio_channel_count" = N können dessen Ausgabewerte zwischen 1 und N liegen.

language_code

string

Nur Ausgabe. Der Sprachcode BCP-47 der Sprache in diesem Ergebnis. Es wurde erkannt, dass dieser Sprachcode wahrscheinlich in der Audiodatei gesprochen wird.

StreamingRecognizeRequest

Die Nachricht auf oberster Ebene, die vom Client an die Methode StreamingRecognize gesendet wird. Es werden mehrere StreamingRecognizeRequest-Nachrichten gesendet. Die erste Nachricht muss eine streaming_config-Nachricht und darf keine audio_content-Daten enthalten. Alle nachfolgenden Nachrichten müssen audio_content enthalten und dürfen keine streaming_config-Nachricht enthalten.

Felder
Union-Feld streaming_request. Die Streaminganfrage, die entweder eine Streamingkonfiguration oder Audioinhalte ist. Für streaming_request ist nur einer der folgenden Werte zulässig:
streaming_config

StreamingRecognitionConfig

Stellt dem Erkennungsmodul Informationen zur Verarbeitung der Anfrage zur Verfügung. Die erste StreamingRecognizeRequest-Nachricht muss eine streaming_config-Nachricht enthalten.

audio_content

bytes

Die zu erkennenden Audiodaten. Sequenzielle Blöcke von Audiodaten werden in sequenziellen StreamingRecognizeRequest-Nachrichten gesendet. Die erste StreamingRecognizeRequest-Nachricht darf keine audio_content-Daten enthalten, alle nachfolgenden StreamingRecognizeRequest-Nachrichten müssen audio_content-Daten enthalten. Die Audiobyte müssen wie in RecognitionConfig angegeben codiert sein. Hinweis: Wie bei allen bytes-Feldern verwenden auch Protokollpuffer eine reine Binärdarstellung (nicht base64). Weitere Informationen

StreamingRecognizeResponse

StreamingRecognizeResponse ist die einzige Nachricht, die von StreamingRecognize an den Client zurückgegeben wird. Eine Reihe von null oder mehr StreamingRecognizeResponse-Nachrichten werden an den Client zurückgestreamt. Wenn kein Audio erkannt wird und single_utterance auf „false“ gesetzt ist, werden keine Nachrichten an den Client zurückgestreamt.

Hier sehen Sie ein Beispiel für eine Reihe von StreamingRecognizeResponse, die bei der Audioverarbeitung zurückgegeben werden können:

  1. results { alternatives { transcript: "seihen" } stability: 0.01 }

  2. results { alternatives { transcript: "seiner" } stability: 0.01 }

  3. results { alternatives { transcript: "sein" } stability: 0.9 } results { alternatives { transcript: " oder nicht sein" } stability: 0.01 }

  4. results { alternatives { transcript: "sein oder nicht sein" confidence: 0.92 } alternatives { transcript: "seihen oder nicht seihen" } is_final: true }

  5. results { alternatives { transcript: " dass ist" } stability: 0.01 }

  6. results { alternatives { transcript: " das ist" } stability: 0.9 } results { alternatives { transcript: " hier die Frage" } stability: 0.01 }

  7. results { alternatives { transcript: " das ist die Frage" confidence: 0.98 } alternatives { transcript: " das war die Frage" } is_final: true }

Hinweise:

  • Nur zwei der oben genannten Antworten (Nr. 4 und Nr. 7) enthalten endgültige Ergebnisse, die durch is_final: true gekennzeichnet sind. Werden diese Ergebnisse zusammengefügt, erhält man das vollständige Transkript: "sein oder nicht sein, das ist die Frage".

  • Die anderen enthalten Zwischenwerte results. #3 und #6 enthalten zwei vorläufige results: Der erste Abschnitt weist eine hohe Stabilität auf und ist weniger anfällig für Änderungen. Der zweite Teil hat eine geringe Stabilität und wird sich wahrscheinlich ändern. Ein UI-Designer kann sich dafür entscheiden, nur results mit hoher Stabilität anzuzeigen.

  • Die oben angegebenen spezifischen Werte für stability und confidence dienen nur zur Veranschaulichung. Die tatsächlichen Werte können davon abweichen.

  • In jeder Antwort wird nur eines der folgenden Felder festgelegt: error, speech_event_type oder eines oder mehrere (wiederholte) results.

Felder
error

Status

Wenn festgelegt, wird eine google.rpc.Status-Nachricht zurückgegeben, die den Fehler für den Vorgang angibt.

results[]

StreamingRecognitionResult

Diese wiederholte Liste enthält null oder mehr Ergebnisse, die aufeinanderfolgenden Teilen der aktuell bearbeiteten Audiodaten entsprechen. Sie enthält null oder ein is_final=true-Ergebnis (den neu abgewickelten Teil), gefolgt von null oder mehr is_final=false-Ergebnissen (den Zwischenergebnissen).

speech_event_type

SpeechEventType

Gibt die Art des Sprachereignisses an.

speech_event_time

Duration

Zeitverschiebung zwischen dem Beginn der Audio- und der Ereignisemission.

total_billed_time

Duration

Wenn verfügbar, abgerechnete Audiosekunden für den Stream. Nur festlegen, wenn dies die letzte Antwort im Stream ist.

speech_adaptation_info

SpeechAdaptationInfo

Liefert Informationen zum Anpassungsverhalten in der Antwort

request_id

int64

Die ID, die der Anfrage zugeordnet ist. Dies ist eine eindeutige ID, die nur für die jeweilige Anfrage gilt.

SpeechEventType

Gibt die Art des Sprachereignisses an.

Enums
SPEECH_EVENT_UNSPECIFIED Kein Sprachereignis angegeben.
END_OF_SINGLE_UTTERANCE Mit diesem Ereignis wird angezeigt, dass vom Server das Ende der sprachlichen Äußerung des Nutzers erkannt wurde und keine weiteren Sprachdaten erwartet werden. Daher werden keine weiteren Audiodaten vom Server verarbeitet (möglicherweise gibt er jedoch noch weitere Ergebnisse aus). Der Client sollte keine weiteren Audiodaten mehr senden, die gRPC-Verbindung in eine Richtung schließen und auf weitere Ergebnisse warten, bis die gRPC-Verbindung vom Server geschlossen wurde. Dieses Ereignis wird nur gesendet, wenn single_utterance auf true festgelegt wurde. Andernfalls wird es nicht verwendet.
SPEECH_ACTIVITY_BEGIN Dieses Ereignis gibt an, dass der Server den Beginn der menschlichen Sprachaktivität im Stream erkannt hat. Dieses Ereignis kann mehrmals zurückgegeben werden, wenn die Sprache im Stream wiederholt beginnt und endet. Dieses Ereignis wird nur gesendet, wenn voice_activity_events auf „true“ gesetzt ist.
SPEECH_ACTIVITY_END Dieses Ereignis gibt an, dass der Server das Ende der menschlichen Sprachaktivität im Stream erkannt hat. Dieses Ereignis kann mehrmals zurückgegeben werden, wenn die Sprache im Stream wiederholt beginnt und endet. Dieses Ereignis wird nur gesendet, wenn voice_activity_events auf „true“ gesetzt ist.
SPEECH_ACTIVITY_TIMEOUT Dieses Ereignis gibt an, dass das vom Nutzer festgelegte Zeitlimit für den Beginn oder das Ende der Sprachaktivität überschritten wurde. Nach dem Empfang dieses Ereignisses wird vom Client erwartet, dass er einen halben Schließvorgang sendet. Weitere Audioinhalte werden nicht verarbeitet.

TranscriptNormalization

Konfiguration der Transkriptionsnormalisierung. Mit der Transkriptnormalisierung können Sie automatisch bestimmte Teile des Transkripts durch von Ihnen ausgewählte Formulierungen ersetzen lassen. Bei StreamingRecognize gilt diese Normalisierung nur für stabile Teiltranskripte (Stabilität > 0, 8) und endgültige Transkripte.

Felder
entries[]

Entry

Eine Liste mit Ersatzeinträgen. Wir werden jeweils einen Eintrag ersetzen. Der zweite Eintrag in ["cat" => "dog", "mountain cat" => "mountain dog"] wird beispielsweise nie angewendet, da der erste Eintrag immer zuerst verarbeitet wird. Maximal 100 Einträge.

Eintrag

Eine einzelne Ersatzkonfiguration.

Felder
search

string

Was ersetzt werden soll. Darf maximal 100 Zeichen lang sein.

replace

string

Wodurch soll sie ersetzt werden? Darf maximal 100 Zeichen lang sein.

case_sensitive

bool

Gibt an, ob bei der Suche zwischen Groß- und Kleinschreibung unterschieden wird.

TranscriptOutputConfig

Gibt ein optionales Ziel für die Erkennungsergebnisse an.

Felder

Union-Feld output_type.

Für output_type ist nur einer der folgenden Werte zulässig:

gcs_uri

string

Gibt einen Cloud Storage-URI für die Erkennungsergebnisse an. Muss im Format gs://bucket_name/object_name angegeben werden und der Bucket muss bereits vorhanden sein.

UpdateCustomClassRequest

Nachricht, die vom Client für die Methode UpdateCustomClass gesendet wird.

Felder
custom_class

CustomClass

Erforderlich. Die benutzerdefinierte Klasse, die aktualisiert werden soll.

Das Feld name der benutzerdefinierten Klasse wird verwendet, um die zu aktualisierende benutzerdefinierte Klasse zu identifizieren. Format:

projects/{project}/locations/{location}/customClasses/{custom_class}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource customClass erforderlich:

  • speech.customClasses.update
update_mask

FieldMask

Die Liste der zu aktualisierenden Felder.

UpdatePhraseSetRequest

Nachricht, die vom Client für die Methode UpdatePhraseSet gesendet wird.

Felder
phrase_set

PhraseSet

Erforderlich. Der zu aktualisierende Wortgruppensatz.

Das Feld name des Satzes wird verwendet, um den zu aktualisierenden Satz zu identifizieren. Format:

projects/{project}/locations/{location}/phraseSets/{phrase_set}

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource phraseSet erforderlich:

  • speech.phraseSets.update
update_mask

FieldMask

Die Liste der zu aktualisierenden Felder.

WordInfo

Wortspezifische Informationen zu erkannten Wörtern

Felder
start_time

Duration

Zeitverschiebung, bezogen auf den Beginn der Audiodaten und entsprechend dem Anfang des gesprochenen Worts. Dieses Feld wird nur bei enable_word_time_offsets=true und nur in der obersten Hypothese festgelegt. Diese Funktion befindet sich in der Entwicklungsphase, sodass die Genauigkeit der Zeitverschiebung variieren kann.

end_time

Duration

Zeitverschiebung, bezogen auf den Beginn der Audiodaten und entsprechend dem Ende des gesprochenen Worts. Dieses Feld wird nur bei enable_word_time_offsets=true und nur in der obersten Hypothese festgelegt. Diese Funktion befindet sich in der Entwicklungsphase, sodass die Genauigkeit der Zeitverschiebung variieren kann.

word

string

Das Wort, auf das sich diese Informationen beziehen.

confidence

float

Eine Konfidenzschätzung zwischen 0,0 und 1,0. Je höher der Wert ist, desto höher ist die geschätzte Wahrscheinlichkeit, dass die Wörter korrekt erkannt wurden. Dieses Feld wird nur für die beste Alternative eines Nicht-Streaming-Ergebnisses oder eines Streaming-Ergebnisses festgelegt, bei dem is_final=true gilt. Die Genauigkeit dieses Feldes kann nicht garantiert werden und Nutzer sollten sich nicht darauf verlassen, dass es immer zur Verfügung steht. Der Standardwert 0,0 ist ein Sentinel-Wert, der angibt, dass confidence nicht festgelegt wurde.

speaker_tag
(deprecated)

int32

Nur Ausgabe. Jedem Sprecher in der Audiodatei wird ein bestimmter Ganzzahlwert zugewiesen. Dieses Feld gibt an, welcher dieser Sprecher jenes Wort gesprochen hat. Der Wertebereich reicht von 1 bis „diarization_speaker_count“. „speaker_tag“ wird festgelegt, wenn „enable_speaker_diarization“ = „true“ ist, und nur für die beste Alternative. Hinweis: Verwenden Sie stattdessen speaker_label.

speaker_label

string

Nur Ausgabe. Ein Labelwert, der jedem einzelnen Sprecher in den Audiodaten zugewiesen wird. Dieses Feld gibt an, welcher Sprecher dieses Wort gesprochen hat. Bei einigen Modellen wie „medical_conversation“ kann dies die tatsächliche Sprecherrolle sein, z. B. „patient“ oder „provider“. In der Regel ist dies jedoch eine Nummer, die einen Sprecher identifiziert. Dieses Feld wird nur festgelegt, wenn „enable_speaker_diarization“ = „true“ ist, und nur für die beste Alternative.