AI_TRANSCRIBE¶

Syntax¶

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

Arguments¶

Required:

audio_file

A FILE type object representing an audio file. Use TO_FILE function to create a reference to your staged file.

Optional:

options

An OBJECT value containing zero or more of the following fields.

• timestamp_granularity: A string specifying the desired timestamp granularity. Possible values are:

  • "word": The file is transcribed as a series of words, each with its own timestamp.

  • "speaker": The file is transcribed as a series of conversational “turns”, each with its own timestamp and speaker label.

  If this field is not specified, the entire file is transcribed as a single segment without timestamps by default.

Returns¶

An string containing a JSON representation of the transcription result. The JSON object contains the following fields:

• "audio_duration": The total duration of the audio file in seconds.

• "text": The transcription of the complete audio file, provided when the timestamp_granularity field is not specified.

• "segments": An array of segments, provided when the timestamp_granularity field is set to "word" or "speaker". Each segment is a JSON object containing the following fields:

  • "start": The start time of the segment in seconds.

  • "end": The end time of the segment in seconds.

  • "text": The transcription text for the segment.

  • "speaker_label": The label of the speaker for the segment, provided when the timestamp_granularity field is set to speaker. Labels are of the form “SPEAKER_00”, “SPEAKER_01”, etc. and are assigned in the order speakers are detected in the audio file.

Access control requirements¶

Users must use a role that has been granted the SNOWFLAKE.CORTEX_USER database role. See Required privileges for more information on this role.

Usage notes¶

• AI_TRANSCRIBE supports the following languages:

  • Arabic

  • Bulgarian

  • Cantonese

  • Catalan

  • Chinese

  • Czech

  • Dutch

  • English

  • French

  • German

  • Greek

  • Hungarian

  • Indonesian

  • Italian

  • Japanese

  • Korean

  • Latvian

  • Polish

  • Portuguese

  • Romanian

  • Russian

  • Serbian

  • Slovenian

  • Spanish

  • Swedish

  • Thai

  • Turkish

  • Ukrainian

• The following audio formats are supported. Factors such as sample rate, bit depth, and number of channels do not affect transcription, although for lossless and/or uncompressed formats, these factors may make the file too large to process. Internally, AI_TRANSCRIBE uses monophonic audio at 16 KHz, and converts input files to this format if necessary.

  • FLAC

  • MP3

  • Ogg

  • WAV

  • WebM

• The maximum audio file size is 700 MB.

• The maximum audio file duration is 60 minutes when timestamp granularity is set to “word” or “speaker”. If timestamp granularity is not used, the maximum duration is 120 minutes.

Examples¶

For examples, see AI Audio examples.

Troubleshooting¶

If the function fails, it returns an error response. Common error messages include:

Regional availability¶

AI_TRANSCRIBE is available in the following regions:

• AWS US West 2 (Oregon)

• AWS US East 1 (N. Virginia)

• AWS EU Central 1 (Frankfurt)

• Azure East US 2 (Virginia)

Legal notices¶

Refer to Snowflake AI and ML.

Limitations¶

Snowflake Cortex functions do not support dynamic tables.