AI_TRANSCRIBE¶

Syntaxe¶

AI_TRANSCRIBE( <audio_file> [ , <options> ] )

Arguments¶

Obligatoire :

audio_file

Un objet de type FILE représentant un fichier audio. Utiliser la fonction TO_FILE pour créer une référence à votre fichier en zone de préparation.

Facultatif :

options

Une valeur OBJECT contenant zéro ou plusieurs des champs suivants.

• timestamp_granularity : Chaîne spécifiant la granularité d’horodatage souhaitée. Les valeurs possibles sont les suivantes :

  • "word" : Le fichier est transcrit sous forme d’une série de mots, chacun avec son propre horodatage.

  • "speaker" : Le fichier est transcrit sous forme d’une série de « tours » de parole , chacun avec son propre horodatage et son propre nom de locuteur.

  Si ce champ n’est pas spécifié, le fichier entier est transcrit en un seul segment sans horodatages par défaut.

Renvoie¶

Une chaîne contenant une représentation JSON du résultat de la transcription. L’objet JSON contient les champs suivants :

• "audio_duration" : La durée totale du fichier audio en secondes.

• "text" : La transcription du fichier audio complet, fournie lorsque le champ timestamp_granularity n’est pas spécifié.

• "segments" : Un tableau de segments, fourni lorsque le champ timestamp_granularity est défini sur "word" ou "speaker". Chaque segment est un objet JSON contenant les champs suivants :

  • "start" : Heure de début du segment en secondes.

  • "end" : Heure de fin du segment en secondes.

  • "text" : Texte de la transcription du segment.

  • "speaker_label" : Le nom du locuteur du segment, fourni lorsque le champ timestamp_granularity est défini sur speaker. Les noms prennent la forme « SPEAKER_00 », « SPEAKER_01 », etc. et sont attribués dans l’ordre où les locuteurs sont détectés dans le fichier audio.

Exigences en matière de contrôle d’accès¶

Les utilisateurs doivent utiliser un rôle auquel le rôle de base de données SNOWFLAKE.CORTEX_USER a été accordé. Voir Privilèges requis pour plus d’informations sur ce rôle.

Notes sur l’utilisation¶

• AI_TRANSCRIBE prend en charge les langues suivantes :

  • Arabe

  • Bulgare

  • Cantonais

  • Catalan

  • Chinois

  • Tchèque

  • Néerlandais

  • Anglais

  • Français

  • Allemand

  • Grec

  • Hongrois

  • Indonésien

  • Italien

  • Japonais

  • Coréen

  • Letton

  • Polonais

  • Portugais

  • Roumain

  • Russe

  • Serbe

  • Slovène

  • Espagnol

  • Suédois

  • Thaïlandais

  • Turc

  • Ukrainien

  Les langues prises en charge sont automatiquement détectées. Pour une détection précise de la langue, l’audio doit commencer dans les cinq premières secondes du fichier.

• Les formats audio suivants sont pris en charge. Des facteurs tels que le taux d’échantillonnage, la profondeur de bits et le nombre de canaux n’ont pas d’incidence sur la transcription, bien que pour les formats sans perte et/ou non compressés, ces facteurs puissent rendre le fichier trop volumineux pour être traité. En interne, AI_TRANSCRIBE utilise un son monophonique de 16 KHz, et convertit les fichiers d’entrée dans ce format si nécessaire.

  • FLAC

  • MP3

  • Ogg

  • WAV

  • WebM

• La taille maximale d’un fichier audio est de 700 MB.

• La durée maximale d’un fichier audio est de 60 minutes lorsque la granularité de l’horodatage est définie sur « mot » ou « locuteur ». Si la granularité de l’horodatage n’est pas utilisée, la durée maximale est de 120 minutes.

Exemples¶

Pour des exemples, voir exemples Audio AI.

Résolution des problèmes¶

Si la fonction échoue, elle renvoie une réponse d’erreur. Les messages d’erreur courants sont les suivants :

Disponibilité régionale¶

AI_TRANSCRIBE est disponible dans les régions suivantes :

• AWS US Ouest 2 (Oregon)

• AWS US East 1 (N. du Nord)

• AWS EU Central 1 (Francfort)

• Azure US Est 2 (Virginie)

Avis juridiques¶

Reportez-vous à Snowflake AI et ML.

Limitations¶

Les fonctions de Snowflake Cortex ne prennent pas en charge les tables dynamiques.