Microsoft Azure Start Transcription Workflow Operation

ID: microsoft-azure-start-transcription

Description

Microsoft Azure Start Transcription invokes the Azure Speech service by passing a file with an audio track to transcript.

Note: You have to configure the Microsoft Azure Transcription Service first to make use this operation. Read the documentation how to achieve it.

Parameter Table

Configuration keys	Description	Default value	Example
source-flavors	The flavors of the media files to use as audio input. Only the first available track will be used.	EMPTY	presenter/delivery
source-tags	The comma separated list of tags of the file to transcribe.	EMPTY	transcript
skip-if-flavor-exists	If this flavor already exists in the media package, skip this operation. To be used when the media package already has a transcript file. Optional	EMPTY	captions/source
language	The language code to use for the transcription. Optional. If set, it will override the configuration language code. Read documentation for supported languages	EMPTY	de-DE
audio-extraction-encoding-profile	The encoding profile to extract audio from media file for transcription.	transcription-azure.audio	audio-to-opus.transcription

One of source-flavors or source-tags must be specified.

Examples

The example below will start the transcription on the first trimmed media file found in the media package, but only if captions/source element doesn't exist yet. The encoding profile to extract the audio stream is custom-transcription-azure.audio.

  # This operation will start the transcription job
  - id: microsoft-azure-start-transcription
    fail-on-error: true
    exception-handler-workflow: partial-error
    description: Start Microsoft Azure transcription job
    configurations:
      - source-flavors: '*/trimmed'
      # Skip this operation if flavor already exists.
      # Used for cases when mediapackage already has captions.
      - skip-if-flavor-exists: captions/source
      - audio-extraction-encoding-profile: custom-transcription-azure.audio

The next example shows you how to create a transcription of the presenter/trimmed media file with the language code de-DE. The transcription will start if captions/source element is missing.

  # This operation will start the transcription job
  - id: microsoft-azure-start-transcription
    fail-on-error: true
    exception-handler-workflow: partial-error
    description: Start Microsoft Azure transcription job
    configurations:
      - source-flavors: presenter/trimmed
      # Skip this operation if flavor already exists.
      # Used for cases when mediapackage already has captions.
      - skip-if-flavor-exists: captions/source
      - language: de-DE