[ aws . chime ]

start-meeting-transcription

Description

Starts transcription for the specified meetingId . For more information, refer to Using Amazon Chime SDK live transcription in the Amazon Chime SDK Developer Guide .

If you specify an invalid configuration, a TranscriptFailed event will be sent with the contents of the BadRequestException generated by Amazon Transcribe. For more information on each parameter and which combinations are valid, refer to the StartStreamTranscription API in the Amazon Transcribe Developer Guide .

Note

Amazon Chime SDK live transcription is powered by Amazon Transcribe. Use of Amazon Transcribe is subject to the AWS Service Terms , including the terms specific to the AWS Machine Learning and Artificial Intelligence Services.

Warning

This API is is no longer supported and will not be updated. We recommend using the latest version, StartMeetingTranscription , in the Amazon Chime SDK.

Using the latest version requires migrating to a dedicated namespace. For more information, refer to Migrating from the Amazon Chime namespace in the Amazon Chime SDK Developer Guide .

See also: AWS API Documentation

Synopsis

  start-meeting-transcription
--meeting-id <value>
--transcription-configuration <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Options

--meeting-id (string)

The unique ID of the meeting being transcribed.

--transcription-configuration (structure)

The configuration for the current transcription operation. Must contain EngineTranscribeSettings or EngineTranscribeMedicalSettings .

EngineTranscribeSettings -> (structure)

The transcription configuration settings passed to Amazon Transcribe.

LanguageCode -> (string)

Specify the language code that represents the language spoken.

If you’re unsure of the language spoken in your audio, consider using IdentifyLanguage to enable automatic language identification.

VocabularyFilterMethod -> (string)

Specify how you want your vocabulary filter applied to your transcript.

To replace words with *** , choose mask .

To delete words, choose remove .

To flag words without changing them, choose tag .

VocabularyFilterName -> (string)

Specify the name of the custom vocabulary filter that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

If you include IdentifyLanguage and want to use one or more vocabulary filters with your transcription, use the VocabularyFilterNames parameter instead.

VocabularyName -> (string)

Specify the name of the custom vocabulary that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

If you use Amazon Transcribe multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

If you include IdentifyLanguage and want to use one or more custom vocabularies with your transcription, use the VocabularyNames parameter instead.

Region -> (string)

The AWS Region in which to use Amazon Transcribe.

If you don’t specify a Region, then the MediaRegion parameter of the CreateMeeting.html API will be used. However, if Amazon Transcribe is not available in the MediaRegion , then a TranscriptFailed event is sent.

Use auto to use Amazon Transcribe in a Region near the meeting’s MediaRegion . For more information, refer to Choosing a transcription Region in the Amazon Chime SDK Developer Guide .

EnablePartialResultsStabilization -> (boolean)

Enables partial result stabilization for your transcription. Partial result stabilization can reduce latency in your output, but may impact accuracy.

PartialResultsStability -> (string)

Specify the level of stability to use when you enable partial results stabilization (EnablePartialResultsStabilization ).

Low stability provides the highest accuracy. High stability transcribes faster, but with slightly lower accuracy.

ContentIdentificationType -> (string)

Labels all personally identifiable information (PII) identified in your transcript. If you don’t include PiiEntityTypes , all PII is identified.

You can’t set ContentIdentificationType and ContentRedactionType .

ContentRedactionType -> (string)

Content redaction is performed at the segment level. If you don’t include PiiEntityTypes , all PII is redacted.

You can’t set ContentIdentificationType and ContentRedactionType .

PiiEntityTypes -> (string)

Specify which types of personally identifiable information (PII) you want to redact in your transcript. You can include as many types as you’d like, or you can select ALL .

Values must be comma-separated and can include: ADDRESS , BANK_ACCOUNT_NUMBER , BANK_ROUTING , CREDIT_DEBIT_CVV , CREDIT_DEBIT_EXPIRY CREDIT_DEBIT_NUMBER , EMAIL ,``NAME`` , PHONE , PIN , SSN , or ALL .

Note that if you include PiiEntityTypes , you must also include ContentIdentificationType or ContentRedactionType .

If you include ContentRedactionType or ContentIdentificationType , but do not include PiiEntityTypes , all PII is redacted or identified.

LanguageModelName -> (string)

Specify the name of the custom language model that you want to use when processing your transcription. Note that language model names are case sensitive.

The language of the specified language model must match the language code. If the languages don’t match, the custom language model isn’t applied. There are no errors or warnings associated with a language mismatch.

If you use Amazon Transcribe in multiple Regions, the custom language model must be available in Amazon Transcribe in each Region.

IdentifyLanguage -> (boolean)

Enables automatic language identification for your transcription.

If you include IdentifyLanguage , you can optionally use LanguageOptions to include a list of language codes that you think may be present in your audio stream. Including language options can improve transcription accuracy.

You can also use PreferredLanguage to include a preferred language. Doing so can help Amazon Transcribe identify the language faster.

You must include either LanguageCode or IdentifyLanguage .

Language identification can’t be combined with custom language models or redaction.

LanguageOptions -> (string)

Specify two or more language codes that represent the languages you think may be present in your media; including more than five is not recommended. If you’re unsure what languages are present, do not include this parameter.

Including language options can improve the accuracy of language identification.

If you include LanguageOptions , you must also include IdentifyLanguage .

Warning

You can only include one language dialect per language. For example, you cannot include en-US and en-AU .

PreferredLanguage -> (string)

Specify a preferred language from the subset of languages codes you specified in LanguageOptions .

You can only use this parameter if you include IdentifyLanguage and LanguageOptions .

VocabularyNames -> (string)

Specify the names of the custom vocabularies that you want to use when processing your transcription. Note that vocabulary names are case sensitive.

If you use Amazon Transcribe in multiple Regions, the vocabulary must be available in Amazon Transcribe in each Region.

If you don’t include IdentifyLanguage and want to use a custom vocabulary with your transcription, use the VocabularyName parameter instead.

VocabularyFilterNames -> (string)

Specify the names of the custom vocabulary filters that you want to use when processing your transcription. Note that vocabulary filter names are case sensitive.

If you use Amazon Transcribe in multiple Regions, the vocabulary filter must be available in Amazon Transcribe in each Region.

If you’re not including IdentifyLanguage and want to use a custom vocabulary filter with your transcription, use the VocabularyFilterName parameter instead.

EngineTranscribeMedicalSettings -> (structure)

The transcription configuration settings passed to Amazon Transcribe Medical.

LanguageCode -> (string)

The language code specified for the Amazon Transcribe Medical engine.

Specialty -> (string)

The specialty specified for the Amazon Transcribe Medical engine.

Type -> (string)

The type of transcription.

VocabularyName -> (string)

The name of the vocabulary passed to Amazon Transcribe Medical.

Region -> (string)

The AWS Region passed to Amazon Transcribe Medical. If you don’t specify a Region, Amazon Chime uses the meeting’s Region.

ContentIdentificationType -> (string)

Labels all personally identifiable information (PII) identified in your transcript. If you don’t include PiiEntityTypes , all PII is identified.

You can’t set ContentIdentificationType and ContentRedactionType .

Shorthand Syntax:

EngineTranscribeSettings={LanguageCode=string,VocabularyFilterMethod=string,VocabularyFilterName=string,VocabularyName=string,Region=string,EnablePartialResultsStabilization=boolean,PartialResultsStability=string,ContentIdentificationType=string,ContentRedactionType=string,PiiEntityTypes=string,LanguageModelName=string,IdentifyLanguage=boolean,LanguageOptions=string,PreferredLanguage=string,VocabularyNames=string,VocabularyFilterNames=string},EngineTranscribeMedicalSettings={LanguageCode=string,Specialty=string,Type=string,VocabularyName=string,Region=string,ContentIdentificationType=string}

JSON Syntax:

{
  "EngineTranscribeSettings": {
    "LanguageCode": "en-US"|"en-GB"|"es-US"|"fr-CA"|"fr-FR"|"en-AU"|"it-IT"|"de-DE"|"pt-BR"|"ja-JP"|"ko-KR"|"zh-CN"|"th-TH"|"hi-IN",
    "VocabularyFilterMethod": "remove"|"mask"|"tag",
    "VocabularyFilterName": "string",
    "VocabularyName": "string",
    "Region": "us-east-2"|"us-east-1"|"us-west-2"|"ap-northeast-2"|"ap-southeast-2"|"ap-northeast-1"|"ca-central-1"|"eu-central-1"|"eu-west-1"|"eu-west-2"|"sa-east-1"|"auto",
    "EnablePartialResultsStabilization": true|false,
    "PartialResultsStability": "low"|"medium"|"high",
    "ContentIdentificationType": "PII",
    "ContentRedactionType": "PII",
    "PiiEntityTypes": "string",
    "LanguageModelName": "string",
    "IdentifyLanguage": true|false,
    "LanguageOptions": "string",
    "PreferredLanguage": "en-US"|"en-GB"|"es-US"|"fr-CA"|"fr-FR"|"en-AU"|"it-IT"|"de-DE"|"pt-BR"|"ja-JP"|"ko-KR"|"zh-CN"|"th-TH"|"hi-IN",
    "VocabularyNames": "string",
    "VocabularyFilterNames": "string"
  },
  "EngineTranscribeMedicalSettings": {
    "LanguageCode": "en-US",
    "Specialty": "PRIMARYCARE"|"CARDIOLOGY"|"NEUROLOGY"|"ONCOLOGY"|"RADIOLOGY"|"UROLOGY",
    "Type": "CONVERSATION"|"DICTATION",
    "VocabularyName": "string",
    "Region": "us-east-1"|"us-east-2"|"us-west-2"|"ap-southeast-2"|"ca-central-1"|"eu-west-1"|"auto",
    "ContentIdentificationType": "PHI"
  }
}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination.

--output (string)

The formatting style for command output.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on
  • off
  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

--cli-binary-format (string)

The formatting style to be used for binary blobs. The default format is base64. The base64 format expects binary blobs to be provided as a base64 encoded string. The raw-in-base64-out format preserves compatibility with AWS CLI V1 behavior and binary values must be passed literally. When providing contents from a file that map to a binary blob fileb:// will always be treated as binary and use the file contents directly regardless of the cli-binary-format setting. When using file:// the file contents will need to properly formatted for the configured cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Disable cli pager for output.

--cli-auto-prompt (boolean)

Automatically prompt for CLI input parameters.

--no-cli-auto-prompt (boolean)

Disable automatically prompt for CLI input parameters.

Output

None