AI_TRANSCRIBE¶

Syntax¶

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

Argumente¶

Benötigt:

audio_file

Ein FILE-Typobjekt, das eine Audiodatei repräsentiert. Verwenden Sie die TO_FILE-Funktion, um einen Verweis auf Ihre Stagingdatei zu erstellen.

Optional:

options

Ein OBJECT-Wert, der null oder mehr der folgenden Felder enthält.

• timestamp_granularity: Eine Zeichenfolge, die die gewünschte Granularität des Zeitstempels angibt. Mögliche Werte sind:

  • "word": Die Datei wird als eine Abfolge von Wörtern transkribiert, jedes mit seinem eigenen Zeitstempel.

  • "speaker": Die Datei wird als eine Reihe von Konversations-„Turns“ transkribiert, jeweils mit einem eigenen Zeitstempel und einer eigenen Sprecherkennzeichnung.

  Wenn dieses Feld nicht angegeben ist, wird die gesamte Datei standardmäßig als ein einziges Segment ohne Zeitstempel transkribiert.

Rückgabewerte¶

Eine Zeichenfolge, die eine JSON-Darstellung des Transkriptionsergebnisses enthält. Das JSON-Objekt enthält die folgenden Felder:

• "audio_duration": Die Gesamtdauer der Audiodatei in Sekunden.

• "text": Die Transkription der vollständigen Audiodatei, die bereitgestellt wird, wenn das timestamp_granularity-Feld nicht angegeben ist.

• "segments": Ein Array von Segmenten, das bereitgestellt wird, wenn das timestamp_granularity-Feld auf "word" oder "speaker" gesetzt ist. Jedes Segment ist ein JSON-Objekt mit den folgenden Feldern:

  • "start": Die Startzeit des Segments in Sekunden.

  • "end": Die Endzeit des Segments in Sekunden.

  • "text": Der Transkriptionstext für das Segment.

  • "speaker_label": Die Bezeichnung des Sprechers für das Segment, die angegeben wird, wenn das timestamp_granularity-Feld auf speaker gesetzt ist. Die Bezeichnungen haben die Form „SPEAKER_00“, „SPEAKER_01“ usw. und werden in der Reihenfolge zugewiesen, in der die Sprecher in der Audiodatei erkannt werden.

Anforderungen an die Zugriffssteuerung¶

Benutzer müssen eine Rolle verwenden, der die Datenbankrolle SNOWFLAKE.CORTEX_USER zugewiesen wurde: Weitere Informationen zu dieser Rolle finden Sie unter Erforderliche Berechtigungen.

Nutzungshinweise¶

• AI_TRANSCRIBE unterstützt die folgenden Sprachen:

  • Arabisch

  • Bulgarisch

  • Kantonesisch

  • Katalanisch

  • Chinesisch

  • Tschechisch

  • Holländisch

  • Englisch

  • Französisch

  • Deutsch

  • Griechisch

  • Ungarisch

  • Indonesisch

  • Italienisch

  • Japanisch

  • Koreanisch

  • Lettisch

  • Polnisch

  • Portugiesisch

  • Rumänisch

  • Russisch

  • Serbisch

  • Slowenisch

  • Spanisch

  • Schwedisch

  • Thailändisch

  • Türkisch

  • Ukrainisch

  Unterstützte Sprachen werden automatisch erkannt. Für eine genaue Spracherkennung muss das Audio innerhalb der ersten fünf Sekunden der Datei beginnen.

• Die folgenden Audioformate werden unterstützt. Faktoren wie Beispielrate, Bittiefe und Anzahl der Kanäle wirken sich nicht auf die Transkription aus, obwohl diese Faktoren bei verlustlosen und/oder unkomprimierten Formaten dazu führen können, dass die Datei zu groß für die Verarbeitung wird. Intern verwendet AI_TRANSCRIBE monophones Audio bei 16 KHzund konvertiert die Eingabedateien bei Bedarf in dieses Format.

  • FLAC

  • MP3

  • Ogg

  • WAV

  • WebM

• Die maximale Größe einer Audiodatei beträgt 700 MB.

• Die maximale Dauer der Audiodatei beträgt 60 Minuten, wenn die Granularität des Zeitstempels auf „Wort“ oder „Sprecher“ eingestellt ist. Wenn keine Granularität des Zeitstempels verwendet wird, beträgt die maximale Dauer 120 Minuten.

Beispiele¶

Weitere Beispiele finden Sie unter AI-Audiobeispiele.

Problembehandlung¶

Wenn die Funktion fehlschlägt, gibt sie eine Fehlerantwort zurück. Häufige Fehlermeldungen sind:

Regionale Verfügbarkeit¶

AI_TRANSCRIBE ist in den folgenden Regionen verfügbar:

• AWS US West 2 (Oregon)

• AWSUS East 1 (N. Virginia)

• AWS EU Central 1 (Frankfurt)

• East US 2 (Virginia)

Rechtliche Hinweise¶

Weitere Informationen dazu finden Sie unter KI und ML in Snowflake.

Einschränkungen¶

Snowflake Cortex-Funktionen unterstützen keine dynamischen Tabellen.