[ aws . transcribe ]
create-language-model
Описание
Создаёт новую пользовательскую модель языка.
При создании новой пользовательской модели языка необходимо указать:
- Требуется ли широкополосная (скорости аудио-выборки более 16 000 Гц) или узкополосная (скорости аудио-выборки менее 16 000 Гц) базовая модель
- Местоположение файлов обучения и настройки (должно быть URI Amazon S3)
- Язык модели
- Уникальное имя для модели
См. также: Документацию API AWS
Синтаксис
create-language-model
--language-code <value>
--base-model-name <value>
--model-name <value>
--input-data-config <value>
[--tags <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]
Параметры
--language-code (строка)
Код языка, представляющий язык вашей модели. Каждая пользовательская модель языка должна содержать термины только одного языка, и язык, который вы выбираете для вашей пользовательской модели языка, должен соответствовать языку ваших обучающих и настраивающих данных.
Список поддерживаемых языков и соответствующих кодов языков см. в таблице Поддерживаемые языки. Обратите внимание, что американский английский (en-US ) — единственный язык, поддерживаемый Amazon Transcribe Medical.
Пользовательская модель языка может использоваться только для транскрибирования файлов на том же языке, что и модель. Например, если вы создадите пользовательскую модель языка, используя американский английский (en-US ), вы сможете применить эту модель только к файлам, содержащим аудио на английском языке.
Возможные значения:
en-UShi-INes-USen-GBen-AUde-DEja-JP
--base-model-name (строка)
Стандартная модель языка Amazon Transcribe или базовая модель, используемая для создания вашей пользовательской модели языка. Amazon Transcribe предлагает два варианта базовых моделей: широкополосную и узкополосную.
Если аудио, которое вы хотите транскрибировать, имеет скорость выборки 16 000 Гц или выше, выберите WideBand . Для транскрибирования аудио со скоростью выборки менее 16 000 Гц выберите NarrowBand .
Возможные значения:
NarrowBandWideBand
--model-name (строка)
Уникальное имя вашей пользовательской модели языка, выбранное вами.
Это имя чувствительно к регистру, не может содержать пробелы и должно быть уникальным в рамках учетной записи Amazon Web Services. Если вы попытаетесь создать новую пользовательскую модель языка с тем же именем, что и существующая пользовательская модель языка, вы получите ошибку ConflictException .
--input-data-config (структура)
Содержит расположение Amazon S3 обучающих данных, которые вы хотите использовать для создания новой пользовательской модели языка, и разрешения для доступа к этому расположению.
При использовании InputDataConfig необходимо включить эти подпараметры: S3Uri , представляющее расположение ваших обучающих данных в Amazon S3, и DataAccessRoleArn , представляющее Amazon Resource Name (ARN) роли, имеющей разрешения для доступа к вашему указанному расположению в Amazon S3. Вы можете дополнительно включить TuningDataS3Uri , представляющее расположение настраивающих данных в Amazon S3. Если вы указываете разные расположения в Amazon S3 для обучающих и настраивающих данных, ARN, который вы используете, должен иметь разрешения для доступа к обоим расположениям.
S3Uri -> (строка)
Расположение в Amazon S3 (URI) текстовых файлов, которые вы хотите использовать для обучения вашей пользовательской модели языка.
Вот пример пути URI: s3://DOC-EXAMPLE-BUCKET/my-model-training-data/
TuningDataS3Uri -> (строка)
Расположение в Amazon S3 (URI) текстовых файлов, которые вы хотите использовать для настройки вашей пользовательской модели языка.
Вот пример пути 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.
Сокращённый синтаксис:
S3Uri=string,TuningDataS3Uri=string,DataAccessRoleArn=string
Синтаксис JSON:
{
"S3Uri": "string",
"TuningDataS3Uri": "string",
"DataAccessRoleArn": "string"
}
--tags (список)
Добавляет одну или несколько пользовательских меток, каждая в виде пары ключ:значение, к новой пользовательской модели языка во время создания этой новой модели.
Дополнительную информацию об использовании меток с Amazon Transcribe см. в разделе Добавление меток к ресурсам.
(структура)
Добавляет метаданные в виде пары ключ:значение к указанному ресурсу.
Например, вы можете добавить метку Department:Sales к ресурсу, чтобы указать, что он относится к отделу продаж вашей организации. Вы также можете использовать метки для управления доступом на основе меток.
Для получения дополнительной информации об использовании меток см. Добавление меток к ресурсам.
Key -> (строка)
Department:Sales ключом является «Department».Value -> (строка)
Вторая часть пары ключ:значение, которая образует метку, связанную с данным ресурсом. Например, в метке Department:Sales значением является «Sales».
Обратите внимание, что вы можете задать значение метки как пустую строку, но вы не можете задать значение метки как null. Пропуск значения метки эквивалентно использованию пустой строки.
Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставленного с двоичным блоком, 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.
Пример 1: Создание пользовательской модели языка с использованием данных обучения и настройки.
Следующий create-language-model пример создаёт пользовательскую модель языка. Вы можете использовать пользовательскую модель языка, чтобы повысить точность транскрипции для таких областей, как право, гостеприимство, финансы и страхование. Для кода языка введите допустимый код языка. Для имени базовой модели укажите базовая модель, которая лучше всего подходит для частоты дискретизации аудио, которое вы хотите транскрибировать с помощью вашей пользовательской модели языка. Для имени модели укажите имя, которое вы хотите дать пользовательской модели языка.
aws transcribe create-language-model \
--language-code language-code \
--base-model-name base-model-name \
--model-name cli-clm-example \
--input-data-config S3Uri="s3://amzn-s3-demo-bucket/Amazon-S3-Prefix-for-training-data",TuningDataS3Uri="s3://amzn-s3-demo-bucket/Amazon-S3-Prefix-for-tuning-data",DataAccessRoleArn="arn:aws:iam::AWS-account-number:role/IAM-role-with-permissions-to-create-a-custom-language-model"
Вывод:
{
"LanguageCode": "language-code",
"BaseModelName": "base-model-name",
"ModelName": "cli-clm-example",
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/Amazon-S3-Prefix/",
"TuningDataS3Uri": "s3://amzn-s3-demo-bucket/Amazon-S3-Prefix/",
"DataAccessRoleArn": "arn:aws:iam::AWS-account-number:role/IAM-role-with-permissions-create-a-custom-language-model"
},
"ModelStatus": "IN_PROGRESS"
}
Дополнительную информацию см. в разделе «Повышение точности транскрипции для конкретных областей с помощью пользовательских моделей языка» в Руководстве разработчика Amazon Transcribe.
Пример 2: Создание пользовательской модели языка с использованием только данных обучения.
Следующий create-language-model пример транскрибирует ваш аудиофайл. Вы можете использовать пользовательскую модель языка, чтобы повысить точность транскрипции для таких областей, как право, гостеприимство, финансы и страхование. Для кода языка введите допустимый код языка. Для имени базовой модели укажите базовая модель, которая лучше всего подходит для частоты дискретизации аудио, которое вы хотите транскрибировать с помощью вашей пользовательской модели языка. Для имени модели укажите имя, которое вы хотите дать пользовательской модели языка.
aws transcribe create-language-model \
--language-code en-US \
--base-model-name base-model-name \
--model-name cli-clm-example \
--input-data-config S3Uri="s3://amzn-s3-demo-bucket/Amazon-S3-Prefix-For-Training-Data",DataAccessRoleArn="arn:aws:iam::AWS-account-number:role/IAM-role-with-permissions-to-create-a-custom-language-model"
Вывод:
{
"LanguageCode": "en-US",
"BaseModelName": "base-model-name",
"ModelName": "cli-clm-example",
"InputDataConfig": {
"S3Uri": "s3://amzn-s3-demo-bucket/Amazon-S3-Prefix-For-Training-Data/",
"DataAccessRoleArn": "arn:aws:iam::your-AWS-account-number:role/IAM-role-with-permissions-to-create-a-custom-language-model"
},
"ModelStatus": "IN_PROGRESS"
}
Дополнительную информацию см. в разделе «Повышение точности транскрипции для конкретных областей с помощью пользовательских моделей языка» в Руководстве разработчика Amazon Transcribe.
Вывод
LanguageCode -> (строка)
BaseModelName -> (строка)
ModelName -> (строка)
InputDataConfig -> (структура)
Перечисляет ARN (Amazon Resource Name) вашей роли доступа к данным и расположения в Amazon S3, которые вы предоставили для данных обучения (S3Uri ) и настройки (TuningDataS3Uri ).
S3Uri -> (строка)
Расположение в Amazon S3 (URI) текстовых файлов, которые вы хотите использовать для обучения вашей пользовательской модели языка.
Вот пример URI пути: s3://DOC-EXAMPLE-BUCKET/my-model-training-data/
TuningDataS3Uri -> (строка)
Расположение в Amazon S3 (URI) текстовых файлов, которые вы хотите использовать для настройки вашей пользовательской модели языка.
Вот пример 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.
ModelStatus -> (строка)
COMPLETED, ваша модель готова к использованию.
© Copyright 2025, Amazon Web Services. Created using Sphinx.