[ aws . transcribe ]
get-medical-transcription-job
Описание
Предоставляет информацию о заданном медицинском задании по транскрипции.
Чтобы просмотреть статус заданного медицинского задания по транскрипции, проверьте поле TranscriptionJobStatus. Если статус равен COMPLETED, задание завершено. Результаты можно найти по адресу, указанному в TranscriptFileUri. Если статус равен FAILED, FailureReason содержит информацию о причинах сбоя вашего задания по транскрипции.
Чтобы получить список ваших медицинских заданий по транскрипции, используйте операцию.
См. также: Документация AWS API
Синтаксис
get-medical-transcription-job
--medical-transcription-job-name <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]
Параметры
--medical-transcription-job-name (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он валидирует входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из вашего файла учетных данных.
--region (строка)
Регион для использования. Переопределяет параметры конфигурации/среды.
--version (строка)
Показать версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- включено
- выключено
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет параметры конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время соединения сокета в секундах. Если значение установлено в 0, соединение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить пейджер cli для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры имеют правила цитирования Unix-подобных. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. использование кавычек со строками в Руководстве пользователя AWS CLI.
Получение информации о конкретном медицинском задании по транскрипции
Следующий пример get-medical-transcription-job получает информацию о конкретном медицинском задании по транскрипции. Чтобы получить доступ к результатам транскрипции, используйте параметр TranscriptFileUri. Если вы включили дополнительные функции для задания по транскрипции, вы можете увидеть их в объекте Settings. Параметр Specialty отображает медицинскую специализацию провайдера. Параметр Type указывает, речь в задании по транскрипции является медицинским разговором или медицинской диктовкой.
aws transcribe get-medical-transcription-job \
--medical-transcription-job-name vocabulary-dictation-medical-transcription-job
Вывод:
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
"TranscriptionJobStatus": "COMPLETED",
"LanguageCode": "en-US",
"MediaSampleRateHertz": 48000,
"MediaFormat": "mp4",
"Media": {
"MediaFileUri": "s3://Amazon-S3-Prefix/your-audio-file.file-extension"
},
"Transcript": {
"TranscriptFileUri": "https://s3.Region.amazonaws.com/Amazon-S3-Prefix/vocabulary-dictation-medical-transcription-job.json"
},
"StartTime": "2020-09-21T21:17:27.045000+00:00",
"CreationTime": "2020-09-21T21:17:27.016000+00:00",
"CompletionTime": "2020-09-21T21:17:59.561000+00:00",
"Settings": {
"ChannelIdentification": false,
"ShowAlternatives": false,
"VocabularyName": "cli-medical-vocab-example"
},
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
Дополнительную информацию см. в разделе Batch Transcription в Руководстве разработчика Amazon Transcribe.
Вывод
MedicalTranscriptionJob -> (структура)
Предоставляет подробную информацию о заданном задании медицинской транскрипции, включая статус задания и, при необходимости, причину сбоя.
MedicalTranscriptionJobName -> (строка)
TranscriptionJobStatus -> (строка)
Предоставляет статус заданного задания медицинской транскрипции.
Если статус равен COMPLETED, задание завершено, и вы можете найти результаты по указанному в TranscriptFileUri расположению. Если статус равен FAILED, FailureReason содержит подробности о причинах сбоя вашего задания транскрипции.
LanguageCode -> (строка)
en-US) — единственный поддерживаемый язык для медицинских транскрипций.MediaSampleRateHertz -> (целое число)
MediaFormat -> (строка)
Media -> (структура)
Описывает расположение в Amazon S3 файла медиа, который вы хотите использовать в своем запросе.
Для получения информации о поддерживаемых форматах медиа, обратитесь к параметру MediaFormat или разделу Форматы медиа в Руководстве разработчика Amazon S3.
MediaFileUri -> (строка)
Расположение файла медиа в Amazon S3, который вы хотите транскрибировать. Например:
s3://DOC-EXAMPLE-BUCKET/my-media-file.flacs3://DOC-EXAMPLE-BUCKET/media-files/my-media-file.flac
Обратите внимание, что ведро Amazon S3, содержащее входные данные медиа, должно находиться в том же регионе Amazon Web Services, где вы выполняете запрос транскрипции.
RedactedMediaFileUri -> (строка)
Расположение файла медиа для редактирования в Amazon S3. Например:
s3://DOC-EXAMPLE-BUCKET/my-media-file.flacs3://DOC-EXAMPLE-BUCKET/media-files/my-media-file.flac
Обратите внимание, что ведро Amazon S3, содержащее входные данные медиа, должно находиться в том же регионе Amazon Web Services, где вы выполняете запрос транскрипции.
Предупреждение
RedactedMediaFileUri создает файл аудио с редактированием дополнительно к редактированному транскрипту. Он поддерживается только для запросов транскрипции Call Analytics (StartCallAnalyticsJob).Transcript -> (структура)
Предоставляет вам URI Amazon S3, который вы можете использовать для доступа к вашей транскрипции.
TranscriptFileUri -> (строка)
Расположение транскрипта в Amazon S3. Вы можете использовать этот URI для доступа к вашей транскрипции или ее загрузки.
Обратите внимание, что это расположение в Amazon S3, которое вы указали в запросе с помощью параметра OutputBucketName.
StartTime -> (метка времени)
Дата и время начала обработки заданного задания медицинской транскрипции.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Например, 2022-05-04T12:32:58.789000-07:00 соответствует заданию транскрипции, которое началось в 12:32 по UTC-7 4 мая 2022 года.
CreationTime -> (метка времени)
Дата и время запроса заданного задания медицинской транскрипции.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Например, 2022-05-04T12:32:58.761000-07:00 соответствует заданию транскрипции, которое началось в 12:32 по UTC-7 4 мая 2022 года.
CompletionTime -> (метка времени)
Дата и время завершения обработки заданного задания медицинской транскрипции.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Например, 2022-05-04T12:33:13.922000-07:00 соответствует заданию транскрипции, которое началось в 12:33 по UTC-7 4 мая 2022 года.
FailureReason -> (строка)
Если TranscriptionJobStatus равно FAILED, то FailureReason содержит информацию о причинах сбоя запроса задания транскрипции.
Поле FailureReason содержит одно из следующих значений:
-
Unsupported media format. Указанный вMediaFormatформат медиа недействителен. Обратитесь к параметруMediaFormatдля получения списка поддерживаемых форматов. -
The media format provided does not match the detected media format. Указанный вMediaFormatформат медиа не соответствует формату входного файла. Проверьте формат медиа вашего файла и исправьте указанное значение. -
Invalid sample rate for audio file. Указанная вMediaSampleRateHertzчастота дискретизации недействительна. Частота дискретизации должна быть в диапазоне от 16 000 до 48 000 герц. -
The sample rate provided does not match the detected sample rate. Указанная вMediaSampleRateHertzчастота дискретизации не соответствует частоте дискретизации, обнаруженной в вашем входном файле медиа. Проверьте частоту дискретизации вашего файла медиа и исправьте указанное значение. -
Invalid file size: file size too large. Размер вашего файла медиа превышает обрабатываемые Amazon Transcribe. Для получения дополнительной информации см. Квоты службы. -
Invalid number of channels: number of channels too large. Ваш аудиофайл содержит больше каналов, чем может обработать Amazon Transcribe. Для получения дополнительной информации см. Квоты службы.
Settings -> (структура)
Предоставляет информацию о дополнительных параметрах, включенных в ваш запрос. Дополнительные параметры включают идентификацию каналов, альтернативные транскрипции, разделение по ораторам, пользовательские словари и фильтры пользовательских словарей.
ShowSpeakerLabels -> (булево значение)
Включает разделение по ораторам (диаризацию) в вашем выходном транскрипте. Разделение по ораторам помечает речь отдельных ораторов в вашем файле медиа.
Если вы включили ShowSpeakerLabels в своем запросе, вы также должны включить MaxSpeakerLabels.
Для получения дополнительной информации см. Разделение ораторов (диаризация).
MaxSpeakerLabels -> (целое число)
Укажите максимальное количество ораторов, которые вы хотите разделить в своем медиа.
Обратите внимание, что если ваше медиа содержит больше ораторов, чем указанное количество, несколько ораторов обрабатываются как один.
Если вы указали поле MaxSpeakerLabels, вы должны установить поле ShowSpeakerLabels в значение true.
ChannelIdentification -> (булево значение)
Включает идентификацию каналов в аудио с несколькими каналами.
Идентификация каналов транскрибирует аудио на каждом канале независимо, а затем добавляет вывод по каждому каналу в один транскрипт.
Если у вас есть аудио с несколькими каналами и вы не включили идентификацию каналов, ваше аудио транскрибируется непрерывно, а ваш транскрипт не разделяет речь по каналам.
Для получения дополнительной информации см. Транскрибирование аудио с несколькими каналами.
ShowAlternatives -> (булево значение)
Чтобы включить альтернативные транскрипции в ваш выходной транскрипт, включите ShowAlternatives в свой запрос транскрипции.
Если вы включите ShowAlternatives, вы также должны включить MaxAlternatives, которое является максимальным количеством альтернативных транскрипций, которые вы хотите сгенерировать Amazon Transcribe Medical.
Для получения дополнительной информации см. Альтернативные транскрипции.
MaxAlternatives -> (целое число)
Укажите максимальное количество альтернативных транскрипций, которые вы хотите включить в свой транскрипт Amazon Transcribe Medical.
Если вы выберете число, большее, чем количество альтернативных транскрипций, сгенерированных Amazon Transcribe Medical, будут включены только фактические альтернативные транскрипции.
Если вы включите MaxAlternatives в свой запрос, вы также должны включить ShowAlternatives со значением true.
Для получения дополнительной информации см. Альтернативные транскрипции.
VocabularyName -> (строка)
Название пользовательского словаря, который вы хотите использовать при обработке задания медицинской транскрипции. Названия пользовательских словарей чувствительны к регистру.
Язык указанного пользовательского словаря должен соответствовать коду языка, который вы указываете в запросе транскрипции. Если языки не совпадают, пользовательский словарь не применяется. Ошибка или предупреждение в связи с несоответствием языков не возникают. Американский английский (en-US) — единственный допустимый язык для Amazon Transcribe Medical.
ContentIdentificationType -> (строка)
Specialty -> (строка)
Type -> (строка)
StartMedicalTranscriptionJob.Tags -> (список)
Теги, каждый в виде пары ключ:значение, назначенные заданному заданию медицинской транскрипции.
(структура)
Добавляет метаданные в виде пары ключ:значение к указанному ресурсу.
Например, вы можете добавить тег Department:Sales к ресурсу, чтобы указать, что он относится к отделу продаж вашей организации. Вы также можете использовать теги для управления доступом на основе тегов.
Для получения дополнительной информации о тегах см. Тегирование ресурсов.
Key -> (строка)
Department:Sales ключом является «Department».Value -> (строка)
Вторая часть пары ключ:значение, образующей тег, связанный с данным ресурсом. Например, в теге Department:Sales значением является «Sales».
Обратите внимание, что вы можете установить значение тега в пустую строку, но не можете установить значение тега в null. Пропуск значения тега эквивалентен использованию пустой строки.
© Copyright 2025, Amazon Web Services. Created using Sphinx.