invoke-model

Описание

Вызывает указанную модель Amazon Bedrock для выполнения вывода с использованием запроса и параметров вывода, предоставленных в теле запроса. Вы используете вывод модели для генерации текста, изображений и вложений.

Пример кода см. в разделе Примеры кода вызова модели в Руководстве пользователя Amazon Bedrock.

Для этого действия требуется разрешение на bedrock:InvokeModel действие.

Предупреждение

Чтобы запретить любой доступ к выводу для ресурсов, которые вы указываете в поле modelId, необходимо запретить доступ к действиям bedrock:InvokeModel и bedrock:InvokeModelWithResponseStream. Это также запрещает доступ к ресурсу через действия API Converse (Converse и ConverseStream). Для получения дополнительной информации см. Запрет доступа для вывода по конкретным моделям.

Для устранения неполадок с некоторыми распространенными ошибками, которые могут возникнуть при использовании API InvokeModel, см. Устранение неполадок с кодами ошибок API Amazon Bedrock в Руководстве пользователя Amazon Bedrock.

См. также: Документация API AWS

Синопсис

  invoke-model
[--body <value>]
[--content-type <value>]
[--accept <value>]
--model-id <value>
[--trace <value>]
[--guardrail-identifier <value>]
[--guardrail-version <value>]
[--performance-config-latency <value>]
<outfile>
[--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]

Параметры

--body (blob)

Запрос и параметры вывода в формате, указанном в contentType в заголовке. Тело должно быть в формате JSON. Чтобы увидеть формат и содержимое тел запросов и ответов для разных моделей, см. Параметры вывода. Для получения дополнительной информации см. Выполнение вывода в Руководстве по Bedrock.

--content-type (строка)

Тип MIME входных данных в запросе. Вы должны указать application/json.

--accept (строка)

Желаемый тип MIME тела вывода в ответе. Значение по умолчанию — application/json.

--model-id (строка)

Уникальный идентификатор модели, которую необходимо вызвать для выполнения вывода.

modelId, который необходимо предоставить, зависит от типа модели или пропускной способности, которую вы используете:

Если вы используете базовую модель, укажите идентификатор модели или её ARN. Список идентификаторов моделей для базовых моделей см. в Руководстве пользователя Amazon Bedrock в разделе Amazon Bedrock base model IDs (on-demand throughput).
Если вы используете профиль вывода, укажите идентификатор профиля вывода или его ARN. Список идентификаторов профилей вывода см. в Руководстве пользователя Amazon Bedrock в разделе Supported Regions and models for cross-region inference.
Если вы используете модель с выделенной пропускной способностью, укажите ARN выделенной пропускной способности. Дополнительную информацию см. в Руководстве пользователя Amazon Bedrock в разделе Выполнение вывода с использованием выделенной пропускной способности.
Если вы используете пользовательскую модель, сначала приобретите выделенную пропускную способность для неё. Затем укажите ARN полученной модели с выделенной пропускной способностью. Дополнительную информацию см. в Руководстве пользователя Amazon Bedrock в разделе Использование пользовательской модели в Amazon Bedrock.
Если вы используете импортированную модель, укажите ARN импортированной модели. Вы можете получить ARN модели из успешного вызова CreateModelImportJob или со страницы Импортированные модели в консоли Amazon Bedrock.

--trace (строка)

Указывает, включить или выключить трассировку Bedrock. При включении вы можете увидеть полную трассировку Bedrock.

Возможные значения:

ENABLED
DISABLED
ENABLED_FULL

--guardrail-identifier (строка)

Уникальный идентификатор ограничения, которое вы хотите использовать. Если вы не предоставите значение, к вызову не будет применено никаких ограничений.

Ошибка будет выброшена в следующих ситуациях.

Вы не предоставляете идентификатор ограничения, но указываете поле amazon-bedrock-guardrailConfig в теле запроса.
Вы включаете ограничение, но contentType не является application/json.
Вы предоставляете идентификатор ограничения, но guardrailVersion не указано.

--guardrail-version (строка)

Номер версии для ограничения. Значение также может быть DRAFT.

--performance-config-latency (строка)

Настройки производительности модели для запроса.

Возможные значения:

standard
optimized

outfile (строка) Имя файла, в котором будет сохранёно содержимое

Глобальные параметры

--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.

Вывод

body -> (blob)

Ответ вывода модели в формате, указанном в заголовке contentType. Чтобы увидеть формат и содержимое тел запросов и ответов для разных моделей, см. Параметры вывода.

contentType -> (строка)

Тип MIME результата вывода.

performanceConfigLatency -> (строка)

Настройки производительности модели для запроса.