[ aws . transcribe ]
list-language-models
Описание
Предоставляет список пользовательских языковых моделей, соответствующих указанным критериям. Если критерии не указаны, возвращаются все пользовательские языковые модели.
Чтобы получить подробную информацию о конкретной пользовательской языковой модели, используйте операцию.
См. также: Документация AWS API
Синтаксис
list-language-models
[--status-equals <value>]
[--name-contains <value>]
[--next-token <value>]
[--max-results <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]
Параметры
--status-equals (строка)
Возвращает только пользовательские языковые модели с указанным статусом. Языковые модели упорядочены по дате создания, начиная с самой новой. Если вы не включите StatusEquals, возвращаются все пользовательские языковые модели.
Возможные значения:
IN_PROGRESSFAILEDCOMPLETED
--name-contains (строка)
--next-token (строка)
ListLanguageModels возвращает больше результатов, чем можно отобразить, NextToken отображается в ответе со связанной строкой. Чтобы получить следующую страницу результатов, скопируйте эту строку и повторите свой запрос, включив NextToken со значением скопированной строки. Повторяйте по мере необходимости, чтобы просмотреть все результаты.--max-results (целое число)
--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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для использования в фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла с учетными данными.
--region (строка)
Используемый регион. Переопределяет настройки из конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- on
- off
- auto
--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.
Чтобы перечислить пользовательские языковые модели
Следующий пример list-language-models показывает список пользовательских языковых моделей, связанных с вашей учетной записью AWS и регионом. Вы можете использовать параметры S3Uri и TuningDataS3Uri, чтобы найти префиксы Amazon S3, которые вы использовали в качестве данных обучения или данных настройки. Название базовой модели указывает, использовали ли вы узкополосную или широкополосную модель для создания пользовательской языковой модели. Вы можете транскрибировать аудио с частотой дискретизации менее 16 кГц с помощью пользовательской языковой модели, используя базовую модель NarrowBand. Вы можете транскрибировать аудио 16 кГц или выше с помощью пользовательской языковой модели, используя базовую модель WideBand. Параметр ModelStatus показывает, можете ли вы использовать пользовательскую языковую модель в задаче транскрипции. Если значение — COMPLETED, вы можете использовать ее в задаче транскрипции.
aws transcribe list-language-models
Вывод:
{
"Models": [
{
"ModelName": "cli-clm-2",
"CreateTime": "2020-09-25T17:57:38.504000+00:00",
"LastModifiedTime": "2020-09-25T17:57:48.585000+00:00",
"LanguageCode": "language-code",
"BaseModelName": "WideBand",
"ModelStatus": "IN_PROGRESS",
"UpgradeAvailability": false,
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/clm-training-data/",
"TuningDataS3Uri": "s3://amzn-s3-demo-bucket/clm-tuning-data/",
"DataAccessRoleArn": "arn:aws:iam::AWS-account-number:role/IAM-role-used-to-create-the-custom-language-model"
}
},
{
"ModelName": "cli-clm-1",
"CreateTime": "2020-09-25T17:16:01.835000+00:00",
"LastModifiedTime": "2020-09-25T17:16:15.555000+00:00",
"LanguageCode": "language-code",
"BaseModelName": "WideBand",
"ModelStatus": "IN_PROGRESS",
"UpgradeAvailability": false,
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/clm-training-data/",
"DataAccessRoleArn": "arn:aws:iam::AWS-account-number:role/IAM-role-used-to-create-the-custom-language-model"
}
},
{
"ModelName": "clm-console-1",
"CreateTime": "2020-09-24T19:26:28.076000+00:00",
"LastModifiedTime": "2020-09-25T04:25:22.271000+00:00",
"LanguageCode": "language-code",
"BaseModelName": "NarrowBand",
"ModelStatus": "COMPLETED",
"UpgradeAvailability": false,
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/clm-training-data/",
"DataAccessRoleArn": "arn:aws:iam::AWS-account-number:role/IAM-role-used-to-create-the-custom-language-model"
}
}
]
}
Дополнительную информацию см. в разделе Улучшение точности транскрипции для конкретных областей с помощью пользовательских языковых моделей в Руководстве разработчика Amazon Transcribe.
Вывод
NextToken -> (строка)
NextToken присутствует в вашем ответе, это означает, что не все результаты отображены. Чтобы просмотреть следующий набор результатов, скопируйте строку, связанную с параметром NextToken в вашем выводе результатов, затем снова выполните свой запрос, включив NextToken со значением скопированной строки. Повторяйте, если необходимо, чтобы просмотреть все результаты.Models -> (список)
Предоставляет информацию о пользовательских языковых моделях, соответствующих критериям, указанным в вашем запросе.
(структура)
Предоставляет информацию о пользовательской языковой модели, включая:
- Имя базовой модели
- Время создания модели
- Расположение файлов, используемых для обучения модели
- Время последнего изменения модели
- Выбранное вами имя модели
- Язык модели
- Состояние обработки модели
- Доступные обновления для базовой модели
ModelName -> (строка)
Уникальное имя, выбранное вами для вашей пользовательской языковой модели.
Это имя чувствительно к регистру, не может содержать пробелы и должно быть уникальным в рамках учетной записи Amazon Web Services.
CreateTime -> (метка времени)
Дата и время создания указанной пользовательской языковой модели.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 представляет 12:32 по UTC-7 4 мая 2022 года.
LastModifiedTime -> (метка времени)
Дата и время последнего изменения указанной пользовательской языковой модели.
Метки времени имеют формат YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC . Например, 2022-05-04T12:32:58.761000-07:00 представляет 12:32 по UTC-7 4 мая 2022 года.
LanguageCode -> (строка)
Код языка, используемый для создания вашей пользовательской языковой модели. Каждая пользовательская языковая модель должна содержать термины только на одном языке, и выбранный вами язык вашей пользовательской языковой модели должен соответствовать языку ваших обучающих и настраиваемых данных.
Список поддерживаемых языков и соответствующих кодов языков см. в таблице Поддерживаемые языки. Обратите внимание, что американский английский (en-US) — единственный язык, поддерживаемый Amazon Transcribe Medical.
BaseModelName -> (строка)
ModelStatus -> (строка)
COMPLETED, модель готова к использованию.UpgradeAvailability -> (булево)
Показывает, доступна ли более новая базовая модель для использования с указанной пользовательской языковой моделью.
Если false, ваша пользовательская языковая модель использует самую последнюю базовую модель.
Если true, доступна более новая базовая модель, чем та, которую использует ваша языковая модель.
Обратите внимание, что для обновления базовой модели необходимо создать пользовательскую языковую модель с новой базовой моделью. Обновления базовых моделей для существующих пользовательских языковых моделей не поддерживаются.
FailureReason -> (строка)
ModelStatus равно FAILED, FailureReason содержит информацию о причинах сбоя запроса пользовательской языковой модели. См. также: Общие ошибки.InputDataConfig -> (структура)
Расположение Amazon S3 входных файлов, используемых для обучения и настройки вашей пользовательской языковой модели, а также ARN роли доступа к данным (Amazon Resource Name), имеющей разрешения на доступ к этим данным.
S3Uri -> (строка)
Расположение (URI) Amazon S3 текстовых файлов, которые вы хотите использовать для обучения вашей пользовательской языковой модели.
Вот пример пути URI: s3://DOC-EXAMPLE-BUCKET/my-model-training-data/
TuningDataS3Uri -> (строка)
Расположение (URI) Amazon S3 текстовых файлов, которые вы хотите использовать для настройки вашей пользовательской языковой модели.
Вот пример пути URI: s3://DOC-EXAMPLE-BUCKET/my-model-tuning-data/
DataAccessRoleArn -> (строка)
Amazon Resource Name (ARN) роли IAM, имеющей разрешения на доступ к ведру Amazon S3, содержащему ваши входные файлы. Если у указанной роли нет соответствующих разрешений на доступ к указанному расположению Amazon S3, ваш запрос завершится ошибкой.
ARN ролей IAM имеют формат arn:partition:iam::account:role/role-name-with-path. Например: arn:aws:iam::111122223333:role/Admin.
Дополнительную информацию см. в разделе IAM ARN.
© Copyright 2025, Amazon Web Services. Created using Sphinx.