Package google.cloud.speech.v1p1beta1

Index

Adaptation

Service qui met en œuvre l'API Google Cloud Speech Adaptation.

CreateCustomClass

rpc CreateCustomClass(CreateCustomClassRequest) returns (CustomClass)

Créez une classe personnalisée.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

CreatePhraseSet

rpc CreatePhraseSet(CreatePhraseSetRequest) returns (PhraseSet)

Créez un ensemble d'indices de phrases. Chaque élément de l'ensemble peut être un mot ou une expression composée de plusieurs mots. Les éléments du PhraseSet sont privilégiés par le modèle de reconnaissance lorsque vous envoyez un appel qui inclut le PhraseSet.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

DeleteCustomClass

rpc DeleteCustomClass(DeleteCustomClassRequest) returns (Empty)

supprimer une classe personnalisée ;

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

DeletePhraseSet

rpc DeletePhraseSet(DeletePhraseSetRequest) returns (Empty)

Supprimer un ensemble de phrases

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

GetCustomClass

rpc GetCustomClass(GetCustomClassRequest) returns (CustomClass)

Obtenez une classe personnalisée.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

GetPhraseSet

rpc GetPhraseSet(GetPhraseSetRequest) returns (PhraseSet)

Obtenez un ensemble de phrases.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

ListCustomClasses

rpc ListCustomClasses(ListCustomClassesRequest) returns (ListCustomClassesResponse)

Répertorie les classes personnalisées.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

ListPhraseSet

rpc ListPhraseSet(ListPhraseSetRequest) returns (ListPhraseSetResponse)

Lister les ensembles de phrases.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

UpdateCustomClass

rpc UpdateCustomClass(UpdateCustomClassRequest) returns (CustomClass)

Mettez à jour une classe personnalisée.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

UpdatePhraseSet

rpc UpdatePhraseSet(UpdatePhraseSetRequest) returns (PhraseSet)

Mettez à jour un ensemble de phrases.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Voix

Service qui met en œuvre l'API Google Cloud Speech.

LongRunningRecognize

rpc LongRunningRecognize(LongRunningRecognizeRequest) returns (Operation)

Effectue une reconnaissance vocale asynchrone : recevez les résultats dans l'interface google.longrunning.Operations. Renvoie un objet Operation.error ou Operation.response contenant un message LongRunningRecognizeResponse. Pour en savoir plus sur la reconnaissance vocale asynchrone, consultez le tutoriel.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Reconnaissance

rpc Recognize(RecognizeRequest) returns (RecognizeResponse)

Effectue une reconnaissance vocale synchrone : recevez les résultats après que toutes les données audio ont été envoyées et traitées.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

StreamingRecognize

rpc StreamingRecognize(StreamingRecognizeRequest) returns (StreamingRecognizeResponse)

Effectue une reconnaissance vocale en continu bidirectionnelle : recevez les résultats tout en envoyant les données audio. Cette méthode n'est disponible que via l'API gRPC (non REST).

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

CreateCustomClassRequest

Message envoyé par le client pour la méthode CreateCustomClass.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle cette classe personnalisée sera créée. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • speech.customClasses.create
custom_class_id

string

Obligatoire. ID à utiliser pour la classe personnalisée, qui constituera le composant final du nom de ressource de la classe personnalisée.

Cette valeur doit être limitée aux lettres, aux chiffres et aux traits d'union. Le premier caractère doit être une lettre et le dernier, une lettre ou un chiffre. Elle doit comporter entre 4 et 63 caractères.

custom_class

CustomClass

Obligatoire. Classe personnalisée à créer.

CreatePhraseSetRequest

Message envoyé par le client pour la méthode CreatePhraseSet.

Champs
parent

string

Obligatoire. Ressource parente dans laquelle cet ensemble de phrases sera créé. Format :

projects/{project}/locations/{location}

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • speech.phraseSets.create
phrase_set_id

string

Obligatoire. ID à utiliser pour l'ensemble de phrases, qui constituera le composant final du nom de ressource de l'ensemble de phrases.

Cette valeur doit être limitée aux lettres, aux chiffres et aux traits d'union. Le premier caractère doit être une lettre et le dernier, une lettre ou un chiffre. Elle doit comporter entre 4 et 63 caractères.

phrase_set

PhraseSet

Obligatoire. Ensemble de phrases à créer.

CustomClass

Ensemble de mots ou d'expressions représentant un concept commun susceptible d'apparaître dans votre contenu audio, par exemple une liste de noms de navires à passagers. Les éléments CustomClass peuvent être substitués dans les espaces réservés que vous définissez dans les expressions PhraseSet.

Champs
name

string

Nom de ressource de la classe personnalisée.

custom_class_id

string

Si cette classe personnalisée est une ressource, custom_class_id correspond à l'ID de ressource de la classe personnalisée. Sensible à la casse.

items[]

ClassItem

Collection d'éléments de cours.

kms_key_name

string

Uniquement en sortie. Nom de la clé KMS avec laquelle le contenu de ClassItem est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kms_key_version_name

string

Uniquement en sortie. Nom de la version de clé KMS avec laquelle le contenu de ClassItem est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Uniquement en sortie. Identifiant unique attribué par le système pour CustomClass. Ce champ n'est pas utilisé.

display_name

string

Uniquement en sortie. Nom lisible et défini par l'utilisateur pour l'objet CustomClass. L'ID ne doit pas contenir plus de 63 caractères Ce champ n'est pas utilisé.

state

State

Uniquement en sortie. État du cycle de vie de l'objet CustomClass. Ce champ n'est pas utilisé.

delete_time

Timestamp

Uniquement en sortie. Heure à laquelle la suppression de cette ressource a été demandée. Ce champ n'est pas utilisé.

expire_time

Timestamp

Uniquement en sortie. Heure à laquelle cette ressource sera supprimée. Ce champ n'est pas utilisé.

annotations

map<string, string>

Uniquement en sortie. Permet aux utilisateurs de stocker de petites quantités de données arbitraires. La clé et la valeur ne doivent pas comporter plus de 63 caractères chacune. 100 annotations au maximum. Ce champ n'est pas utilisé.

etag

string

Uniquement en sortie. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Peut être envoyé lors des requêtes de mise à jour, de restauration et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. Ce champ n'est pas utilisé.

reconciling

bool

Uniquement en sortie. Indique si cet objet CustomClass est en cours de mise à jour. Ce champ n'est pas utilisé.

ClassItem

Élément de la classe.

Champs
value

string

Valeur de l'élément de classe.

État

Ensemble d'états qui définissent le cycle de vie d'un objet CustomClass.

Enums
STATE_UNSPECIFIED État non spécifié. Cette valeur n'est utilisée/utile que pour distinguer les valeurs non définies.
ACTIVE État normal et actif.
DELETED Cet objet CustomClass a été supprimé.

DeleteCustomClassRequest

Message envoyé par le client pour la méthode DeleteCustomClass.

Champs
name

string

Obligatoire. Nom de la classe personnalisée à supprimer. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • speech.customClasses.delete

DeletePhraseSetRequest

Message envoyé par le client pour la méthode DeletePhraseSet.

Champs
name

string

Obligatoire. Nom de l'ensemble de phrases à supprimer. Format :

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • speech.phraseSets.delete

GetCustomClassRequest

Message envoyé par le client pour la méthode GetCustomClass.

Champs
name

string

Obligatoire. Nom de la classe personnalisée à récupérer. Format :

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

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • speech.customClasses.get

GetPhraseSetRequest

Message envoyé par le client pour la méthode GetPhraseSet.

Champs
name

string

Obligatoire. Nom de l'ensemble de phrases à récupérer. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • speech.phraseSets.get

ListCustomClassesRequest

Message envoyé par le client pour la méthode ListCustomClasses.

Champs
parent

string

Obligatoire. Parent qui possède cette collection de classes personnalisées. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • speech.customClasses.list
page_size

int32

Nombre maximal de classes personnalisées à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 classes personnalisées au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Jeton de page reçu d'un appel ListCustomClass précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListCustomClass doivent correspondre à l'appel ayant fourni le jeton de page.

ListCustomClassesResponse

Message renvoyé au client par la méthode ListCustomClasses.

Champs
custom_classes[]

CustomClass

Classes personnalisées.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListPhraseSetRequest

Message envoyé par le client pour la méthode ListPhraseSet.

Champs
parent

string

Obligatoire. Parent qui possède cette collection d'ensembles de phrases. Format :

projects/{project}/locations/{location}

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • speech.phraseSets.list
page_size

int32

Nombre maximal d'ensembles d'expressions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 ensembles d'expressions au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Jeton de page reçu d'un appel ListPhraseSet précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListPhraseSet doivent correspondre à l'appel ayant fourni le jeton de page.

ListPhraseSetResponse

Message renvoyé au client par la méthode ListPhraseSet.

Champs
phrase_sets[]

PhraseSet

Ensemble de phrases.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

LongRunningRecognizeMetadata

Décrit la progression d'un appel LongRunningRecognize de longue durée. Elle est incluse dans le champ metadata de l'Operation renvoyée par l'appel GetOperation du service google::longrunning::Operations.

Champs
progress_percent

int32

Pourcentage approximatif des données audio traitées jusqu'à présent. Une fois les informations entièrement traitées et les résultats disponibles, cette valeur est égale à 100.

start_time

Timestamp

Heure de réception de la requête.

last_update_time

Timestamp

Heure de la mise à jour de traitement la plus récente.

uri

string

Uniquement en sortie. URI du fichier audio en cours de transcription. Vide si l'audio a été envoyé sous forme de contenu d'octets.

output_config

TranscriptOutputConfig

Uniquement en sortie. Copie de TranscriptOutputConfig s'il a été défini dans la requête.

LongRunningRecognizeRequest

Message de premier niveau envoyé par le client pour la méthode LongRunningRecognize.

Champs
config

RecognitionConfig

Obligatoire. Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête.

audio

RecognitionAudio

Obligatoire. Données audio à reconnaître.

output_config

TranscriptOutputConfig

Facultatif. Spécifie une destination facultative pour les résultats de la reconnaissance.

LongRunningRecognizeResponse

Le seul message renvoyé au client par la méthode LongRunningRecognize. Il fournit le résultat sous la forme de zéro ou davantage de messages séquentiels SpeechRecognitionResult. Elle est incluse dans le champ result.response de l'Operation renvoyée par l'appel GetOperation du service google::longrunning::Operations.

Champs
results[]

SpeechRecognitionResult

Liste séquentielle des résultats de transcription correspondant à des parties séquentielles de l'audio.

total_billed_time

Duration

Le cas échéant, secondes audio facturées pour la requête correspondante.

output_config

TranscriptOutputConfig

Configuration de sortie d'origine, le cas échéant, dans la requête.

output_error

Status

Si la transcription échoue, ce champ contient l'erreur correspondante.

speech_adaptation_info

SpeechAdaptationInfo

Fournit des informations sur le comportement d'adaptation vocale dans la réponse

request_id

int64

ID associé à la requête. Il s'agit d'un identifiant unique propre à la requête en question.

PhraseSet

Fournit des "indices" à l'outil de reconnaissance vocale pour privilégier certains mots et expressions dans les résultats.

Champs
name

string

Nom de ressource de l'ensemble de phrases.

phrases[]

Phrase

Une liste de mots et d'expressions.

boost

float

Boost d'indices Une valeur positive augmentera la probabilité qu'une expression spécifique soit reconnue par rapport à d'autres expressions similaires. Plus le boost est élevé, plus le risque de faux positif est élevé. Les valeurs de boost négatives correspondent à l'anti-biais. L'anti-biais n'est pas activé. Le boost négatif sera donc ignoré. Bien que boost puisse accepter un large éventail de valeurs positives, la plupart des cas d'utilisation sont mieux adaptés aux valeurs comprises entre 0 (exclus) et 20. Nous vous recommandons d'utiliser une approche de recherche binaire pour trouver la valeur optimale pour votre cas d'utilisation, ainsi que d'ajouter des expressions avec et sans boost à vos requêtes.

kms_key_name

string

Uniquement en sortie. Nom de la clé KMS avec laquelle le contenu de PhraseSet est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kms_key_version_name

string

Uniquement en sortie. Nom de la version de clé KMS avec laquelle le contenu de PhraseSet est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Uniquement en sortie. Identifiant unique attribué par le système pour le PhraseSet. Ce champ n'est pas utilisé.

display_name

string

Uniquement en sortie. Nom lisible et défini par l'utilisateur pour l'objet PhraseSet. L'ID ne doit pas contenir plus de 63 caractères Ce champ n'est pas utilisé.

state

State

Uniquement en sortie. État du cycle de vie de l'objet CustomClass. Ce champ n'est pas utilisé.

delete_time

Timestamp

Uniquement en sortie. Heure à laquelle la suppression de cette ressource a été demandée. Ce champ n'est pas utilisé.

expire_time

Timestamp

Uniquement en sortie. Heure à laquelle cette ressource sera supprimée. Ce champ n'est pas utilisé.

annotations

map<string, string>

Uniquement en sortie. Permet aux utilisateurs de stocker de petites quantités de données arbitraires. La clé et la valeur ne doivent pas comporter plus de 63 caractères chacune. 100 annotations au maximum. Ce champ n'est pas utilisé.

etag

string

Uniquement en sortie. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Peut être envoyé lors des requêtes de mise à jour, de restauration et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. Ce champ n'est pas utilisé.

reconciling

bool

Uniquement en sortie. Indique si cet objet PhraseSet est en cours de mise à jour. Ce champ n'est pas utilisé.

Expression

Phrases contenant des mots et des expressions qui fournissent des indications afin que la reconnaissance vocale soit plus susceptible de les reconnaître. Cette liste permet d'améliorer la précision de certains termes et phrases, notamment dans des commandes spécifiques généralement prononcées par l'utilisateur. Elle offre également la possibilité d'ajouter des mots supplémentaires au vocabulaire de l'outil de reconnaissance. Consultez les limites d'utilisation pour en savoir plus.

Les éléments de liste peuvent également inclure des classes prédéfinies ou personnalisées contenant des groupes de mots qui représentent des concepts courants apparaissant dans le langage naturel. Par exemple, plutôt que de fournir un indice de phrase pour chaque mois de l'année (par exemple, "je suis né en janvier", "je suis né en février", etc.), l'utilisation de la classe $MONTH prédéfinie augmente la probabilité de transcrire correctement les contenus audio comprenant des mois (par exemple, "je suis né en $month"). Pour faire référence à des classes prédéfinies, utilisez le symbole de la classe précédé de $ (par exemple, $MONTH). Pour faire référence à des classes personnalisées définies de manière intégrée dans la requête, définissez le custom_class_id de la classe sur une chaîne unique pour toutes les ressources de classe et les classes intégrées. Utilisez ensuite l'ID de la classe entre ${...}, par exemple "${my-months}". Pour faire référence à des ressources de classes personnalisées, utilisez l'ID de la classe entre ${} (par exemple, ${my-months}).

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

Champs
value

string

L'expression elle-même.

boost

float

Boost d'indices Remplace l'amélioration définie au niveau de l'ensemble d'expressions. Une valeur positive augmentera la probabilité qu'une expression spécifique soit reconnue par rapport à d'autres expressions similaires. Plus le boost est élevé, plus le risque de faux positif est élevé. Le boosting négatif sera simplement ignoré. Bien que boost puisse accepter un large éventail de valeurs positives, la plupart des cas d'utilisation sont mieux adaptés aux valeurs comprises entre 0 et 20. Nous vous recommandons d'utiliser une approche de recherche binaire pour trouver la valeur optimale pour votre cas d'utilisation, ainsi que d'ajouter des expressions avec et sans boost à vos requêtes.

État

Ensemble d'états qui définissent le cycle de vie d'un objet CustomClass.

Enums
STATE_UNSPECIFIED État non spécifié. Cette valeur n'est utilisée/utile que pour distinguer les valeurs non définies.
ACTIVE État normal et actif.
DELETED Cet objet CustomClass a été supprimé.

RecognitionAudio

Contient des données audio dans l'encodage spécifié dans RecognitionConfig. Vous devez fournir la valeur content ou uri. Si vous n'en spécifiez aucune ou si vous spécifiez les deux, vous obtenez l'erreur google.rpc.Code.INVALID_ARGUMENT. Consultez la section Limites relatives au contenu.

Champs
Champ d'union audio_source. Correspond à la source audio, qui se présente sous la forme de contenu intégré ou d'un URI Cloud Storage. audio_source ne peut être qu'un des éléments suivants :
content

bytes

Les octets de données audio sont encodés comme spécifié dans RecognitionConfig. Remarque : Comme pour tous les champs d'octets, les tampons de protocole utilisent une représentation binaire pure, tandis que les représentations JSON sont encodées en base64.

uri

string

URI qui pointe vers un fichier contenant des octets de données audio, comme spécifié dans RecognitionConfig. Le fichier ne doit pas être compressé (par exemple, au format gzip). Actuellement, seuls les URI Google Cloud Storage sont acceptés. Ils doivent être spécifiés au format suivant : gs://bucket_name/object_name (les autres formats d'URI renvoient google.rpc.Code.INVALID_ARGUMENT). Pour en savoir plus, consultez la section URI de la demande.

RecognitionConfig

Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête.

Champs
encoding

AudioEncoding

Encodage des données audio envoyées dans tous les messages RecognitionAudio. Ce champ est facultatif pour les fichiers audio FLAC et WAV, mais obligatoire pour tous les autres formats audio. Pour plus d'informations, consultez la section AudioEncoding.

sample_rate_hertz

int32

Taux d'échantillonnage en hertz des données audio envoyées dans tous les messages RecognitionAudio. Les valeurs possibles sont comprises entre 8 000 et 48 000. La valeur optimale est 16 000. Pour de meilleurs résultats, définissez le taux d'échantillonnage de la source audio sur 16 000 Hz. Si ce n'est pas possible, utilisez le taux d'échantillonnage natif de la source audio (plutôt que d'effectuer un ré-échantillonnage). Ce champ est facultatif pour les fichiers audio FLAC et WAV, mais obligatoire pour tous les autres formats audio. Pour en savoir plus, consultez AudioEncoding.

audio_channel_count

int32

Nombre de canaux dans les données audio d'entrée. Ne définissez ce champ QUE pour la reconnaissance MULTICANAL. Les valeurs valides pour LINEAR16, OGG_OPUS et FLAC sont comprises entre 1 et 8. La valeur pour MULAW, AMR, AMR_WB et SPEEX_WITH_HEADER_BYTE doit être définie sur 1 pour être valide. Si elle est égale à 0 ou est omise, un seul canal (mono) est pris en compte. Remarque : nous ne reconnaissons que le premier canal par défaut. Pour effectuer une reconnaissance indépendante sur chaque canal, attribuez la valeur "true" au champ enable_separate_recognition_per_channel.

enable_separate_recognition_per_channel

bool

Ce champ doit être explicitement défini sur true et audio_channel_count doit être supérieur à 1 pour que chaque canal soit reconnu séparément. Le résultat de la reconnaissance contiendra un champ channel_tag indiquant le canal auquel il appartient. Si la valeur est différente de "true", nous ne reconnaîtrons que le premier canal. La requête vous est également facturée de façon cumulative pour tous les canaux reconnus : (audio_channel_count multiplié par la longueur de l'audio).

language_code

string

Obligatoire. Langue de l'audio fourni en tant que tag de langue BCP-47. Exemple : "en-US". Consultez la section Langues acceptées pour obtenir la liste des codes de langue actuellement compatibles.

alternative_language_codes[]

string

Liste de 3 tags de langue BCP-47 supplémentaires répertoriant les autres langues possibles de l'audio fourni. Consultez la section Langues acceptées pour obtenir la liste des codes de langue actuellement compatibles. Si d'autres langues sont répertoriées, la reconnaissance renverra un résultat dans la langue la plus probablement détectée, ainsi que le champ language_code principal. Le résultat de la reconnaissance inclura le tag de la langue détectée dans l'audio. Remarque : cette fonctionnalité est uniquement disponible pour les cas d'utilisation de commande vocale et de recherche vocale et les performances peuvent varier pour d'autres cas d'utilisation (par exemple, la transcription d'appels téléphoniques).

max_alternatives

int32

Nombre maximal d'hypothèses de reconnaissance à renvoyer. Plus précisément, le nombre maximal de messages SpeechRecognitionAlternative dans chaque SpeechRecognitionResult. Le serveur peut renvoyer un nombre inférieur à max_alternatives. Les valeurs valides sont comprises entre 0 et 30. Une valeur de 0 ou 1 renverra un maximum d'un résultat. Si celle-ci est omise, un maximum de 1 est également renvoyé.

profanity_filter

bool

Si le champ est défini sur true, le serveur tente de filtrer le langage grossier en remplaçant tous les caractères (sauf le premier) de chaque mot filtré par des astérisques. Par exemple : "p*****". Si la valeur est false ou si le champ est omis, les grossièretés ne sont pas filtrées.

adaptation

SpeechAdaptation

La configuration de l'adaptation vocale améliore la précision de la reconnaissance vocale. Pour en savoir plus, consultez la documentation sur l'adaptation vocale. Lorsque l'adaptation vocale est définie, elle remplace le champ speech_contexts.

transcript_normalization

TranscriptNormalization

Facultatif. Utilisez la normalisation de la transcription pour remplacer automatiquement des parties de la transcription par les expressions de votre choix. Pour StreamingRecognize, cette normalisation ne s'applique qu'aux transcriptions partielles stables (stabilité > 0,8) et aux transcriptions finales.

speech_contexts[]

SpeechContext

Tableau SpeechContext. Moyen de fournir du contexte pour faciliter la reconnaissance vocale. Pour en savoir plus, consultez Adaptation vocale.

enable_word_time_offsets

bool

Si la valeur est true, le premier résultat inclut une liste de mots et les décalages temporels de début et de fin (horodatages) associés. Si la valeur est false, aucun horodatage au niveau du mot n'est renvoyé. La valeur par défaut est false.

enable_word_confidence

bool

Si la valeur est true, le premier résultat inclut une liste de mots ainsi que leur fiabilité. Si la valeur est false, aucune information de fiabilité au niveau du mot n'est renvoyée. La valeur par défaut est false.

enable_automatic_punctuation

bool

Si le champ est défini sur "true", ajoute un signe de ponctuation aux hypothèses de résultat de la reconnaissance. Cette fonctionnalité n'est disponible que pour certaines langues. La définition de ce champ pour d'autres langues n'a aucun effet. La valeur "false" par défaut n'ajoute pas de signe de ponctuation aux hypothèses de résultat.

enable_spoken_punctuation

BoolValue

Comportement vis-à-vis de la ponctuation énoncée pour l'appel.Si ce champ n'est pas défini, le comportement par défaut est utilisé en fonction du modèle choisi (par exemple, command_and_search active la ponctuation énoncée par défaut). Si la valeur est "true", la ponctuation énoncée est remplacée par les symboles correspondants dans la requête. Par exemple, "comment allez-vous point d'interrogation" devient "Comment allez-vous ?" Pour obtenir de l'aide, consultez https://cloud.google.com/speech-to-text/docs/spoken-punctuation. Si la valeur est "false", la ponctuation orale n'est pas remplacée.

enable_spoken_emojis

BoolValue

Comportement vis-à-vis des emoji énoncés pour l'appel. Si ce champ n'est pas défini, le comportement par défaut est utilisé en fonction du modèle choisi. Si la valeur est "true", ajoute la mise en forme des emoji énoncés pour la requête. Les emoji énoncés seront remplacés par les symboles Unicode correspondants dans la transcription finale. Si la valeur est "false", les emoji prononcés ne sont pas remplacés.

enable_speaker_diarization
(deprecated)

bool

Si le champ est défini sur "true", cela active la détection du locuteur pour chaque mot reconnu dans la première alternative au résultat de la reconnaissance à l'aide d'un speaker_label fourni dans WordInfo. Remarque : Utilisez plutôt diarization_config.

diarization_speaker_count
(deprecated)

int32

Si cette option est définie, elle spécifie le nombre estimé de locuteurs dans la conversation. La valeur par défaut est "2". Ignoré, sauf si enable_speaker_diarization est défini sur "true". Remarque : Utilisez plutôt diarization_config.

diarization_config

SpeakerDiarizationConfig

Configuration pour activer l'identification du locuteur et définir des paramètres supplémentaires pour adapter l'identification à votre application. Remarque : Lorsque cette option est activée, tous les mots du début de l'audio sont envoyés comme première alternative dans chaque réponse STREAMING consécutive. Cela permet d'améliorer nos tags de locuteurs car nos modèles apprennent à identifier les locuteurs dans la conversation au fil du temps. Pour les requêtes non diffusées en continu, les résultats de l'identification ne seront fournis que dans l'alternative supérieure du résultat SpeechRecognitionResult FINAL.

metadata

RecognitionMetadata

Métadonnées concernant cette demande.

model

string

Modèle à sélectionner pour la requête donnée. Sélectionnez le modèle le mieux adapté à votre domaine pour obtenir de meilleurs résultats. Si aucun modèle n'est explicitement spécifié, nous en sélectionnons automatiquement un en fonction des paramètres du champ RecognitionConfig.

Modèle Description

latest_long

Idéal pour les contenus longs tels que les médias ou les conversations.

latest_short

Idéal pour les contenus courts, comme les commandes ou les énoncés brefs et orientés.

command_and_search

Idéal pour les requêtes courtes telles que les commandes ou la recherche vocales.

phone_call

Idéal pour les données audio provenant d'un appel téléphonique (généralement enregistrées à un taux d'échantillonnage de 8 kHz).

video

Idéal pour les données audio provenant d'une vidéo ou comprenant plusieurs intervenants. Il est préférable que l'audio soit enregistré à un taux d'échantillonnage de 16 kHz ou plus. Il s'agit d'un modèle premium plus onéreux que le tarif standard.

default

Idéal pour les données audio qui ne font pas partie des modèles spécifiques, telles que des données audio de longue durée. Il est préférable d'utiliser un son haute-fidélité, enregistré à un taux d'échantillonnage de 16 kHz ou plus.

medical_conversation

Idéal pour les données audio provenant d'une conversation entre un prestataire de santé et un patient.

medical_dictation

Idéal pour les données audio provenant de notes dictées par un professionnel de santé.

use_enhanced

bool

Définissez sur "true" pour utiliser un modèle amélioré pour la reconnaissance vocale. Si use_enhanced est défini sur "true" et que le champ model n'est pas défini, un modèle amélioré approprié est choisi s'il en existe un pour l'audio.

Si use_enhanced est défini sur "true" et qu'il n'existe pas de version améliorée du modèle spécifié, la reconnaissance vocale utilise la version standard du modèle spécifié.

AudioEncoding

L'encodage des données audio envoyées dans la requête.

Tous les encodages n'acceptent qu'un seul canal (mono) audio, sauf si les champs audio_channel_count et enable_separate_recognition_per_channel sont définis.

Pour des résultats optimaux, la source audio doit être enregistrée et transmise grâce à un encodage sans perte (FLAC ou LINEAR16). La précision de la reconnaissance vocale peut être réduite si vous enregistrez ou transmettez des données audio à l'aide de codecs induisant une perte, notamment en présence de bruits de fond. Les codecs MULAW, AMR, AMR_WB, OGG_OPUS, SPEEX_WITH_HEADER_BYTE, MP3 et WEBM_OPUS sont des exemples de codecs induisant une perte.

Les fichiers audio FLAC et WAV comprennent un en-tête décrivant le contenu audio inclus. Vous pouvez demander une reconnaissance pour les fichiers WAV qui contiennent des données audio encodées au format LINEAR16 ou MULAW. Si vous envoyez le format de fichier audio FLAC ou WAV dans votre requête, vous n'avez pas besoin de spécifier un AudioEncoding ; le format d'encodage audio est déterminé à partir de l'en-tête du fichier. Si vous spécifiez une valeur AudioEncoding lorsque vous envoyez des données audio FLAC ou WAV, la configuration de codage doit correspondre au codage décrit dans l'en-tête audio. Sinon, la requête renvoie un code d'erreur google.rpc.Code.INVALID_ARGUMENT.

Enums
ENCODING_UNSPECIFIED Non spécifié.
LINEAR16 Échantillons little-endian de 16 bits signés et non compressés (LPCM).
FLAC L'encodage FLAC (Free Lossless Audio Codec, codec audio sans perte gratuit) est recommandé du fait de son absence de perte. Ainsi, la reconnaissance n'est pas compromise et ne nécessite qu'environ la moitié de la bande passante par rapport à l'encodage LINEAR16. L'encodage de flux FLAC accepte les échantillons 16 bits et 24 bits. Il n'est toutefois pas compatible avec tous les champs de STREAMINFO.
MULAW Échantillons de 8 bits compressant des échantillons audio 14 bits qui utilisent la norme G.711 PCMU/MULAW.
AMR Codec bande étroite AMR. La valeur sample_rate_hertz doit être de 8 000.
AMR_WB Codec large bande AMR. La valeur sample_rate_hertz doit être de 16 000.
OGG_OPUS Trames audio encodées au format Opus dans un conteneur Ogg (OggOpus). La valeur sample_rate_hertz doit être définie sur 8 000, 12 000, 16 000, 24 000 ou 48 000.
SPEEX_WITH_HEADER_BYTE Bien que l'utilisation d'encodages avec perte ne soit pas recommandée, OGG_OPUS est largement privilégié par rapport à Speex lorsqu'un encodage à très faible débit est requis. L'encodage Speex accepté par l'API Cloud Speech comporte un octet d'en-tête dans chaque bloc, comme dans le type MIME audio/x-speex-with-header-byte. Il s'agit d'une variante de l'encodage Speex RTP défini dans le RFC 5574. Le flux est une séquence de blocs qui correspondent chacun à un paquet RTP. Chaque bloc commence par un octet qui contient sa longueur exprimée en octets, suivie d'une ou de plusieurs trames de données Speex complétées jusqu'à atteindre un nombre entier d'octets, comme spécifié dans le RFC 5574. En d'autres termes, chaque en-tête RTP est remplacé par un octet unique contenant la longueur du bloc. Seul l'encodage Speex large bande est accepté. La valeur sample_rate_hertz doit être de 16 000.
MP3 Audio MP3. L'encodage MP3 est une fonctionnalité bêta disponible uniquement dans la version v1p1beta1. Compatibilité avec tous les débits MP3 standards (de 32 à 320 kbit/s). Lorsque vous utilisez cet encodage, sample_rate_hertz doit correspondre au taux d'échantillonnage du fichier utilisé.
WEBM_OPUS Trames audio encodées au format Opus dans le conteneur WebM (WebM). sample_rate_hertz doit être défini sur 8 000, 12 000, 16 000, 24 000 ou 48 000.
ALAW Échantillons de 8 bits compressant des échantillons audio 13 bits qui utilisent la norme G.711 PCMU/ALAW.

RecognitionMetadata

Description des données audio à reconnaître.

Champs
interaction_type

InteractionType

Cas d'utilisation décrivant le mieux le contenu audio à reconnaître.

industry_naics_code_of_audio

uint32

Marché vertical auquel cette requête de reconnaissance vocale s'applique le plus étroitement. Il s'agit du champ indiquant le mieux les sujets contenus dans les données audio. Vous pouvez identifier le marché vertical à l'aide du code SCIAN à 6 chiffres. Consultez la page https://www.naics.com/search/ pour en savoir plus.

microphone_distance

MicrophoneDistance

Type audio décrivant le mieux le son reconnu.

original_media_type

OriginalMediaType

Média original sur lequel le discours a été enregistré.

recording_device_type

RecordingDeviceType

Type d'appareil avec lequel le discours a été enregistré.

recording_device_name

string

Appareil utilisé pour l'enregistrement. Exemples : "Nexus 5X", "Polycom SoundStation IP 6000", "POTS", 'VoIP" ou "Microphone cardioïde".

original_mime_type

string

Type MIME du fichier audio d'origine. Par exemple, audio/m4a, audio/x-alaw-basic, audio/mp3, audio/3gpp. Une liste des types MIME audio possibles est disponible sur http://www.iana.org/assignments/media-types/media-types.xhtml#audio.

obfuscated_id
(deprecated)

int64

ID masqué de l'utilisateur (protection des données confidentielles). Permet d'identifier le nombre d'utilisateurs uniques du service.

audio_topic

string

Description du contenu. Par exemple, "Enregistrements des audiences de la Cour suprême fédérale depuis 2012".

InteractionType

Catégories de cas d'utilisation pour lesquels la requête de reconnaissance audio peut être décrite.

Énumérations (Enums)
INTERACTION_TYPE_UNSPECIFIED Le cas d'utilisation est inconnu ou ne s'apparente pas à l'une des valeurs ci-dessous.
DISCUSSION Plusieurs personnes dans une conversation. Par exemple : une réunion à laquelle deux personnes ou plus participent activement. Généralement, les principaux intervenants se situent dans la même pièce (dans le cas contraire, reportez-vous à PHONE_CALL).
PRESENTATION Une ou plusieurs personnes donnant un cours ou une présentation, sans interruption ou presque.
PHONE_CALL Appel téléphonique ou vidéoconférence où deux personnes ou plus, qui ne sont pas dans la même pièce, participent activement.
VOICEMAIL Message enregistré destiné à quelqu'un d'autre.
PROFESSIONALLY_PRODUCED Contenu audio produit de façon professionnelle (tel qu'une émission télévisée ou un podcast).
VOICE_COMMAND Transcription de commandes vocales permettant par exemple de contrôler un appareil.
DICTATION Transcription d'un discours en texte pour créer un document écrit tel qu'un SMS, un e-mail ou un rapport.

MicrophoneDistance

Énumère les types de paramètres d'enregistrement qui décrivent un fichier audio.

Énumérations (Enums)
MICROPHONE_DISTANCE_UNSPECIFIED Le type audio n'est pas connu.
NEARFIELD Le son a été enregistré à partir d'un microphone rapproché, tel qu'un téléphone, dictaphone ou microphone à main. L'intervenant se trouve généralement à moins d'un mètre du microphone.
MIDFIELD L'intervenant se situe à moins de trois mètres du microphone.
FARFIELD L'intervenant se situe à plus de trois mètres du microphone.

OriginalMediaType

Média original sur lequel le discours a été enregistré.

Énumérations (Enums)
ORIGINAL_MEDIA_TYPE_UNSPECIFIED Type de média original inconnu.
AUDIO Les données vocales se présentent sous la forme d'un enregistrement audio.
VIDEO Les données vocales ont été enregistrées au format vidéo.

RecordingDeviceType

Type d'appareil avec lequel le discours a été enregistré.

Énumérations (Enums)
RECORDING_DEVICE_TYPE_UNSPECIFIED L'appareil d'enregistrement est inconnu.
SMARTPHONE Le discours a été enregistré depuis un smartphone.
PC Le discours a été enregistré à partir d'un ordinateur ou d'une tablette.
PHONE_LINE Le discours a été enregistré sur une ligne téléphonique.
VEHICLE Le discours a été enregistré dans un véhicule.
OTHER_OUTDOOR_DEVICE Le discours a été enregistré en extérieur.
OTHER_INDOOR_DEVICE Le discours a été enregistré en intérieur.

RecognizeRequest

Message de premier niveau envoyé par le client pour la méthode Recognize.

Champs
config

RecognitionConfig

Obligatoire. Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête.

audio

RecognitionAudio

Obligatoire. Données audio à reconnaître.

RecognizeResponse

Le seul message renvoyé au client par la méthode Recognize. Il fournit le résultat sous la forme de zéro ou davantage de messages séquentiels SpeechRecognitionResult.

Champs
results[]

SpeechRecognitionResult

Liste séquentielle des résultats de transcription correspondant à des parties séquentielles de l'audio.

total_billed_time

Duration

Le cas échéant, secondes audio facturées pour la requête correspondante.

speech_adaptation_info

SpeechAdaptationInfo

Fournit des informations sur le comportement d'adaptation dans la réponse

request_id

int64

ID associé à la requête. Il s'agit d'un identifiant unique propre à la requête en question.

using_legacy_models

bool

Indique si la requête utilisait d'anciens modèles ASR (n'a pas été migrée automatiquement pour utiliser des modèles conformer).

SpeakerDiarizationConfig

Configuration permettant d'activer l'identification des locuteurs.

Champs
enable_speaker_diarization

bool

Si le champ est défini sur "true", cela active la détection du locuteur pour chaque mot reconnu dans la première alternative au résultat de la reconnaissance à l'aide d'un speaker_label fourni dans WordInfo.

min_speaker_count

int32

Nombre minimal de locuteurs dans la conversation. Cette plage vous offre plus de flexibilité en permettant au système de déterminer automatiquement le nombre approprié de locuteurs. Si le nombre n'est pas défini, la valeur par défaut est 2.

max_speaker_count

int32

Nombre maximal de locuteurs dans la conversation. Cette plage vous offre plus de flexibilité en permettant au système de déterminer automatiquement le nombre approprié de locuteurs. Si le nombre n'est pas défini, la valeur par défaut est 6.

speaker_tag
(deprecated)

int32

Uniquement en sortie. Non utilisé.

SpeechAdaptation

Configuration de l'adaptation vocale.

Champs
phrase_sets[]

PhraseSet

Collection d'ensembles de phrases. Pour spécifier les indices de manière intégrée, laissez le champ name de l'ensemble de phrases vide et remplissez les autres champs. N'importe quel ensemble de phrases peut utiliser n'importe quelle classe personnalisée.

phrase_set_references[]

string

Collection de noms de ressources d'ensembles d'expressions à utiliser.

custom_classes[]

CustomClass

Ensemble de classes personnalisées. Pour spécifier les classes de manière intégrée, laissez le champ name de la classe vide et remplissez les autres champs en lui attribuant un custom_class_id unique. Faites référence à la classe définie en ligne dans les indices de phrases par son custom_class_id.

abnf_grammar

ABNFGrammar

La forme Backus-Naur augmentée (ABNF) est une notation grammaticale standardisée composée d'un ensemble de règles de dérivation. Consultez les spécifications : https://www.w3.org/TR/speech-grammar

ABNFGrammar

Champs
abnf_strings[]

string

Toutes les déclarations et règles d'une grammaire ABNF sont divisées en plusieurs chaînes qui seront concaténées.

SpeechAdaptationInfo

Informations sur l'utilisation de l'adaptation vocale dans les résultats

Champs
adaptation_timeout

bool

Indique si un délai d'attente a été dépassé lors de l'application de l'adaptation vocale. Si la valeur est "true", l'adaptation n'a eu aucun effet sur la transcription de la réponse.

timeout_message

string

Si ce champ est défini, il renvoie un message indiquant la partie de la requête d'adaptation vocale qui a expiré.

SpeechContext

Fournit des "indices" à l'outil de reconnaissance vocale pour privilégier certains mots et expressions dans les résultats.

Champs
phrases[]

string

Liste de chaînes contenant des mots et des expressions qui fournissent des indications afin que la reconnaissance vocale soit plus susceptible de les reconnaître. Cette liste permet d'améliorer la précision de certains termes et phrases, notamment dans des commandes spécifiques généralement prononcées par l'utilisateur. Elle offre également la possibilité d'ajouter des mots supplémentaires au vocabulaire de l'outil de reconnaissance. Consultez les limites d'utilisation pour en savoir plus.

Les éléments de liste peuvent également être définis sur des classes pour des groupes de mots qui représentent des concepts courants dans le langage naturel. Par exemple, plutôt que de fournir des indices de phrases pour chaque mois de l'année, l'utilisation de la classe $MONTH améliore la probabilité de transcrire correctement les contenus audio comprenant des mois.

boost

float

Boost d'indices Une valeur positive augmentera la probabilité qu'une expression spécifique soit reconnue par rapport à d'autres expressions similaires. Plus le boost est élevé, plus le risque de faux positif est élevé. Les valeurs de boost négatives correspondent à l'anti-biais. L'anti-biais n'est pas activé. Le boost négatif sera donc ignoré. Bien que boost puisse accepter un large éventail de valeurs positives, la plupart des cas d'utilisation sont mieux adaptés aux valeurs comprises entre 0 et 20. Nous vous recommandons d'utiliser une approche de recherche binaire pour trouver la valeur optimale pour votre cas d'utilisation.

SpeechRecognitionAlternative

Hypothèses alternatives (liste des n meilleures)

Champs
transcript

string

Texte de transcription représentant les mots prononcés par l'utilisateur. Dans les langues qui utilisent des espaces pour séparer les mots, la transcription peut comporter un espace au début si elle n'est pas le premier résultat. Vous pouvez concaténer chaque résultat pour obtenir la transcription complète sans utiliser de séparateur.

confidence

float

Estimation de fiabilité comprise entre 0,0 et 1,0. Un nombre élevé indique une plus grande probabilité estimée que les mots reconnus soient corrects. Ce champ n'est défini que pour la première alternative d'un résultat n'étant pas sous forme de flux, ou d'un résultat de flux dans lequel is_final=true. La précision de ce champ n'est pas garantie. Les utilisateurs ne devraient pas s'attendre à ce qu'il soit toujours fourni. La valeur par défaut de 0,0 est une valeur sentinelle indiquant que la valeur confidence n'a pas été définie.

words[]

WordInfo

Liste d'informations spécifiques au mot pour chaque mot reconnu. Remarque : Lorsque enable_speaker_diarization est défini sur "true", tous les mots sont visibles depuis le début de l'audio.

SpeechRecognitionResult

Résultat de reconnaissance vocale correspondant à une partie des données audio.

Champs
alternatives[]

SpeechRecognitionAlternative

Peut contenir une ou plusieurs hypothèses de reconnaissance (jusqu'au nombre maximal spécifié dans max_alternatives). Ces alternatives sont classées par ordre de précision, la première étant la plus probable, selon le classement de l'outil de reconnaissance.

channel_tag

int32

Avec des données audio multicanaux, il s'agit du numéro de canal correspondant au résultat reconnu pour les données audio provenant de ce canal. Si audio_channel_count = N, les valeurs de sortie peuvent aller de "1" à "N".

result_end_time

Duration

Décalage temporel de la fin de ce résultat par rapport au début de l'audio.

language_code

string

Uniquement en sortie. Le tag de langue BCP-47 dans ce résultat. Ce code de langue a été détecté comme ayant le plus de chances d'être parlé dans l'audio.

StreamingRecognitionConfig

Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête.

Champs
config

RecognitionConfig

Obligatoire. Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête.

single_utterance

bool

Si le champ est défini sur false ou omis, le système effectue une reconnaissance continue (il attend les données audio et les traite même lorsque l'utilisateur s'arrête de parler) jusqu'à ce que le client interrompe le flux d'entrée (API gRPC) ou que la limite de temps maximale soit atteinte. Peut renvoyer plusieurs résultats StreamingRecognitionResult avec l'option is_final définie sur true.

Si la valeur est true, l'outil de reconnaissance détecte un seul énoncé parlé. Lorsqu'il détecte une pause ou une interruption, il renvoie un événement END_OF_SINGLE_UTTERANCE et cesse la reconnaissance. Il ne renverra pas plus d'un StreamingRecognitionResult avec l'option is_final définie sur true.

Le champ single_utterance ne peut être utilisé qu'avec des modèles spécifiés. Dans le cas contraire, une erreur est générée. Le champ model dans RecognitionConfig doit être défini sur :

  • command_and_search
  • phone_call ET champ supplémentaire useEnhanced=true
  • Le champ model n'est pas défini. Dans ce cas, l'API sélectionne automatiquement un modèle en fonction des autres paramètres que vous définissez dans RecognitionConfig.
interim_results

bool

Si la valeur est true, des résultats intermédiaires (hypothèses provisoires) peuvent être renvoyés dès qu'ils sont disponibles (ces résultats intermédiaires sont indiqués par l'indicateur is_final=false). Si la valeur est false ou omise, seul(s) le(s) résultat(s) is_final=true est/sont renvoyé(s).

enable_voice_activity_events

bool

Si la valeur est true, les réponses avec des événements vocaux d'activité vocale sont renvoyées au fur et à mesure de leur détection.

voice_activity_timeout

VoiceActivityTimeout

Si cette valeur est définie, le serveur ferme automatiquement le flux une fois la durée spécifiée écoulée après l'envoi du dernier événement vocal VOICE_ACTIVITY. Le champ voice_activity_events doit également être défini sur "true".

VoiceActivityTimeout

Événements pour lesquels un délai avant expiration peut être défini pour l'activité Voice.

Champs
speech_start_timeout

Duration

Durée avant expiration du flux si aucune activité vocale ne commence.

speech_end_timeout

Duration

Durée d'expiration du flux après la fin de la parole.

StreamingRecognitionResult

Résultat de reconnaissance vocale correspondant à une partie des données audio en cours de traitement.

Champs
alternatives[]

SpeechRecognitionAlternative

Peut contenir une ou plusieurs hypothèses de reconnaissance (jusqu'au nombre maximal spécifié dans max_alternatives). Ces alternatives sont classées par ordre de précision, la première étant la plus probable, selon le classement de l'outil de reconnaissance.

is_final

bool

Si le champ est défini sur false, le résultat StreamingRecognitionResult constitue un élément provisoire susceptible de changer. S'il est défini sur true, c'est la dernière fois que le service vocal renvoie ce résultat StreamingRecognitionResult spécifique. L'outil de reconnaissance ne renverra plus aucune autre hypothèse pour cette partie de la transcription et de l'audio correspondant.

stability

float

Une estimation de la probabilité que l'outil de reconnaissance ne modifie pas sa supposition relative au résultat provisoire. Les valeurs s'étendent de 0,0 (complètement instable) à 1,0 (complètement stable). Ce champ n'est fourni que pour les résultats provisoires (is_final=false). La valeur par défaut de 0.0 est une valeur sentinelle indiquant que la stabilité stability n'a pas été définie.

result_end_time

Duration

Décalage temporel de la fin de ce résultat par rapport au début de l'audio.

channel_tag

int32

Avec des données audio multicanaux, il s'agit du numéro de canal correspondant au résultat reconnu pour les données audio provenant de ce canal. Si audio_channel_count = N, les valeurs de sortie peuvent aller de "1" à "N".

language_code

string

Uniquement en sortie. Le tag de langue BCP-47 dans ce résultat. Ce code de langue a été détecté comme ayant le plus de chances d'être parlé dans l'audio.

StreamingRecognizeRequest

Message de premier niveau envoyé par le client pour la méthode StreamingRecognize. Plusieurs messages StreamingRecognizeRequest sont envoyés. Le premier message doit contenir un message streaming_config et ne doit pas contenir de données audio_content. Tous les messages suivants doivent contenir des données audio_content et pas de message streaming_config.

Champs
Champ d'union streaming_request. Requête de flux, qui correspond à une configuration de flux ou à du contenu audio. streaming_request ne peut être qu'un des éléments suivants :
streaming_config

StreamingRecognitionConfig

Fournit à l'outil de reconnaissance des informations qui spécifient comment traiter la requête. Le premier message StreamingRecognizeRequest doit contenir un message streaming_config.

audio_content

bytes

Données audio à reconnaître. Des blocs séquentiels de données audio sont envoyés dans des messages StreamingRecognizeRequest séquentiels. Le premier message StreamingRecognizeRequest ne doit pas contenir de données audio_content et tous les messages StreamingRecognizeRequest suivants doivent contenir des données audio_content. Les octets de données audio doivent être encodés comme spécifié dans RecognitionConfig. Remarque : comme pour tous les champs d'octets, les tampons de protocole utilisent une représentation binaire pure (sans encodage base64). Consultez la section Limites relatives au contenu.

StreamingRecognizeResponse

StreamingRecognizeResponse est le seul message renvoyé au client par StreamingRecognize. Une série de zéro messages StreamingRecognizeResponse ou plus est renvoyée au client. S'il n'y a pas d'audio reconnaissable, et que le champ single_utterance est défini sur "false", aucun message n'est retransmis au client.

Voici un exemple de série de StreamingRecognizeResponse pouvant être renvoyées lors du traitement du contenu audio :

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

  2. results { alternatives { transcript: "to be a" } stability: 0.01 }

  3. results { alternatives { transcript: "to be" } stability: 0.9 } results { alternatives { transcript: " or not to be" } stability: 0.01 }

  4. results { alternatives { transcript: "to be or not to be" confidence: 0.92 } alternatives { transcript: "to bee or not to bee" } is_final: true }

  5. results { alternatives { transcript: " that's" } stability: 0.01 }

  6. results { alternatives { transcript: " that is" } stability: 0.9 } results { alternatives { transcript: " the question" } stability: 0.01 }

  7. results { alternatives { transcript: " that is the question" confidence: 0.98 } alternatives { transcript: " that was the question" } is_final: true }

Remarques :

  • Parmi les réponses ci-dessus, seules les lignes 4 et 7 contiennent des résultats finaux, indiqués par is_final: true. En combinant ces réponses, nous obtenons l'intégralité de la transcription : "to be or not to be that is the question" ("être ou ne pas être, telle est la question").

  • Les autres contiennent des results intermédiaires. Les réponses n° 3 et 6 contiennent deux results intermédiaires : la première partie présente une grande stabilité et est moins susceptible de changer. La deuxième partie présente une faible stabilité et est très susceptible de changer. Les concepteurs d'interface utilisateur peuvent choisir de n'afficher que des champs results de stabilité élevée.

  • Les valeurs stability et confidence spécifiques indiquées ci-dessus ne sont données qu'à titre d'exemple. Les valeurs réelles peuvent varier.

  • Dans chaque réponse, un seul de ces champs sera défini : error, speech_event_type ou un ou plusieurs results (répétés).

Champs
error

Status

Si ce champ est défini, il renvoie un message google.rpc.Status qui spécifie l'erreur associée à l'opération.

results[]

StreamingRecognitionResult

Cette liste répétée contient zéro résultats ou plus, correspondant à des parties consécutives de l'audio en cours de traitement. Elle contient zéro ou un résultat is_final=true (la partie nouvellement configurée), suivi de zéro ou plusieurs résultats is_final=false (les résultats intermédiaires).

speech_event_type

SpeechEventType

Indique le type d'événement de discours.

speech_event_time

Duration

Décalage temporel entre le début de l'audio et l'émission d'un événement.

total_billed_time

Duration

Nombre de secondes audio facturées pour le flux, le cas échéant. Définissez cette valeur uniquement s'il s'agit de la dernière réponse du flux.

speech_adaptation_info

SpeechAdaptationInfo

Fournit des informations sur le comportement d'adaptation dans la réponse

request_id

int64

ID associé à la requête. Il s'agit d'un identifiant unique propre à la requête en question.

SpeechEventType

Indique le type d'événement de discours.

Énumérations (Enums)
SPEECH_EVENT_UNSPECIFIED Aucun événement de discours spécifié.
END_OF_SINGLE_UTTERANCE Cet événement indique que le serveur a détecté la fin de l'énoncé de l'utilisateur et ne s'attend plus à aucune entrée vocale. Le serveur ne traite donc pas de nouvelles données audio (bien qu'il puisse par la suite renvoyer des résultats supplémentaires). Le client doit arrêter d'envoyer des données audio, interrompre à moitié la connexion gRPC, et attendre les résultats supplémentaires jusqu'à ce que le serveur stoppe cette connexion. Cet événement n'est envoyé que si le champ single_utterance est défini sur true et n'est pas utilisé par ailleurs.
SPEECH_ACTIVITY_BEGIN Cet événement indique que le serveur a détecté le début d'une activité vocale humaine dans le flux. Cet événement peut être renvoyé plusieurs fois si la parole commence et s'arrête à plusieurs reprises tout au long du flux. Cet événement n'est envoyé que si voice_activity_events est défini sur "true".
SPEECH_ACTIVITY_END Cet événement indique que le serveur a détecté la fin de l'activité vocale humaine dans le flux. Cet événement peut être renvoyé plusieurs fois si la parole commence et s'arrête à plusieurs reprises tout au long du flux. Cet événement n'est envoyé que si voice_activity_events est défini sur "true".
SPEECH_ACTIVITY_TIMEOUT Cet événement indique que le délai défini par l'utilisateur pour le début ou la fin de l'activité vocale a été dépassé. Lorsqu'il reçoit cet événement, le client doit envoyer une fermeture à moitié. Aucun autre contenu audio ne sera traité.

TranscriptNormalization

Configuration de la normalisation de la transcription. Utilisez la normalisation de la transcription pour remplacer automatiquement des parties de la transcription par les expressions de votre choix. Pour StreamingRecognize, cette normalisation ne s'applique qu'aux transcriptions partielles stables (stabilité > 0,8) et aux transcriptions finales.

Champs
entries[]

Entry

Liste des entrées de remplacement. Nous effectuerons le remplacement d'une entrée à la fois. Par exemple, la deuxième entrée de ["cat" => "dog", "mountain cat" => "mountain dog"] ne sera jamais appliquée, car nous traiterons toujours la première entrée avant. 100 entrées au maximum.

Entrée

Configuration de remplacement unique.

Champs
search

string

Ce que vous souhaitez remplacer. La longueur maximale est de 100 caractères.

replace

string

Par quoi remplacer le texte. La longueur maximale est de 100 caractères.

case_sensitive

bool

Indique si la recherche est sensible à la casse.

TranscriptOutputConfig

Spécifie une destination facultative pour les résultats de la reconnaissance.

Champs

Champ d'union output_type.

output_type ne peut être qu'un des éléments suivants :

gcs_uri

string

Spécifie un URI Cloud Storage pour les résultats de la reconnaissance. Il doit être spécifié au format gs://bucket_name/object_name et le bucket doit déjà exister.

UpdateCustomClassRequest

Message envoyé par le client pour la méthode UpdateCustomClass.

Champs
custom_class

CustomClass

Obligatoire. Classe personnalisée à mettre à jour.

Le champ name de la classe personnalisée permet d'identifier la classe personnalisée à mettre à jour. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource customClass indiquée :

  • speech.customClasses.update
update_mask

FieldMask

Liste des champs à mettre à jour.

UpdatePhraseSetRequest

Message envoyé par le client pour la méthode UpdatePhraseSet.

Champs
phrase_set

PhraseSet

Obligatoire. Ensemble de phrases à mettre à jour.

Le champ name de l'ensemble de phrases permet d'identifier l'ensemble à mettre à jour. Format :

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

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

L'autorisation IAM suivante est requise pour la ressource phraseSet indiquée :

  • speech.phraseSets.update
update_mask

FieldMask

Liste des champs à mettre à jour.

WordInfo

Informations spécifiques au mot pour les mots reconnus.

Champs
start_time

Duration

Décalage temporel relatif au début des données audio et correspondant au début du mot prononcé. Ce champ n'est défini que si enable_word_time_offsets=true, et uniquement dans la première hypothèse. Il s'agit d'une fonctionnalité expérimentale. La précision du décalage temporel peut varier.

end_time

Duration

Décalage temporel relatif au début des données audio et correspondant à la fin du mot prononcé. Ce champ n'est défini que si enable_word_time_offsets=true, et uniquement dans la première hypothèse. Il s'agit d'une fonctionnalité expérimentale. La précision du décalage temporel peut varier.

word

string

Mot correspondant à cet ensemble d'informations.

confidence

float

Estimation de fiabilité comprise entre 0,0 et 1,0. Un nombre élevé indique une plus grande probabilité estimée que les mots reconnus soient corrects. Ce champ n'est défini que pour la première alternative d'un résultat n'étant pas sous forme de flux, ou d'un résultat de flux dans lequel is_final=true. La précision de ce champ n'est pas garantie. Les utilisateurs ne devraient pas s'attendre à ce qu'il soit toujours fourni. La valeur par défaut de 0,0 est une valeur sentinelle indiquant que la valeur confidence n'a pas été définie.

speaker_tag
(deprecated)

int32

Uniquement en sortie. Une valeur entière distincte est attribuée à chaque locuteur de l'audio. Ce champ spécifie lequel de ces locuteurs a été détecté pour avoir prononcé ce mot. La valeur est comprise entre "1" et "diarization_speaker_count". La valeur speaker_tag est définie lorsque enable_speaker_diarization = "true", et uniquement pour la première alternative. Remarque : Utilisez plutôt speaker_label.

speaker_label

string

Uniquement en sortie. Valeur de l'étiquette attribuée à chaque locuteur unique dans le contenu audio. Ce champ spécifie le locuteur détecté comme ayant prononcé ce mot. Pour certains modèles, comme medical_conversation, il peut s'agir du rôle réel de l'interlocuteur (par exemple, "patient" ou "prestataire"), mais il s'agit généralement d'un nombre identifiant un interlocuteur. Ce champ n'est défini que si enable_speaker_diarization = "true", et uniquement pour la première alternative.