Class: Aws::BedrockRuntime::Types::InvokeModelRequest

Inherits:

Struct

• Object
• Struct
• Aws::BedrockRuntime::Types::InvokeModelRequest

Includes:

Structure

Defined in:

lib/aws-sdk-bedrockruntime/types.rb

Overview

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[:body]

Instance Attribute Summary

• #accept ⇒ String

  The desired MIME type of the inference body in the response.

• #body ⇒ String

  The prompt and inference parameters in the format specified in the ‘contentType` in the header.

• #content_type ⇒ String

  The MIME type of the input data in the request.

• #guardrail_identifier ⇒ String

  The unique identifier of the guardrail that you want to use.

• #guardrail_version ⇒ String

  The version number for the guardrail.

• #model_id ⇒ String

  The unique identifier of the model to invoke to run inference.

• #performance_config_latency ⇒ String

  Model performance settings for the request.

• #trace ⇒ String

  Specifies whether to enable or disable the Bedrock trace.

Instance Attribute Details

#accept ⇒ String

The desired MIME type of the inference body in the response. The default value is ‘application/json`.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#body ⇒ String

The prompt and inference parameters in the format specified in the ‘contentType` in the header. You must provide the body in JSON format. To see the format and content of the request and response bodies for different models, refer to [Inference parameters]. For more information, see [Run inference] in the Bedrock User Guide.

[1]: docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html [2]: docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#content_type ⇒ String

The MIME type of the input data in the request. You must specify ‘application/json`.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#guardrail_identifier ⇒ String

The unique identifier of the guardrail that you want to use. If you don’t provide a value, no guardrail is applied to the invocation.

An error will be thrown in the following situations.

• You don’t provide a guardrail identifier but you specify the ‘amazon-bedrock-guardrailConfig` field in the request body.

• You enable the guardrail but the ‘contentType` isn’t ‘application/json`.

• You provide a guardrail identifier, but ‘guardrailVersion` isn’t specified.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#guardrail_version ⇒ String

The version number for the guardrail. The value can also be ‘DRAFT`.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#model_id ⇒ String

The unique identifier of the model to invoke to run inference.

The ‘modelId` to provide depends on the type of model or throughput that you use:

• If you use a base model, specify the model ID or its ARN. For a list of model IDs for base models, see [Amazon Bedrock base model IDs (on-demand throughput)] in the Amazon Bedrock User Guide.

• If you use an inference profile, specify the inference profile ID or its ARN. For a list of inference profile IDs, see [Supported Regions and models for cross-region inference] in the Amazon Bedrock User Guide.

• If you use a provisioned model, specify the ARN of the Provisioned Throughput. For more information, see [Run inference using a Provisioned Throughput] in the Amazon Bedrock User Guide.

• If you use a custom model, first purchase Provisioned Throughput for it. Then specify the ARN of the resulting provisioned model. For more information, see [Use a custom model in Amazon Bedrock] in the Amazon Bedrock User Guide.

• If you use an [imported model], specify the ARN of the imported model. You can get the model ARN from a successful call to

  CreateModelImportJob][6

  or from the Imported models page in the

  Amazon Bedrock console.

[1]: docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns [2]: docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference-support.html [3]: docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html [4]: docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html [5]: docs.aws.amazon.com/bedrock/latest/userguide/model-customization-import-model.html [6]: docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateModelImportJob.html

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#performance_config_latency ⇒ String

Model performance settings for the request.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end

#trace ⇒ String

Specifies whether to enable or disable the Bedrock trace. If enabled, you can see the full Bedrock trace.

Returns:

• (String)

# File 'lib/aws-sdk-bedrockruntime/types.rb', line 1959

class InvokeModelRequest < Struct.new(
  :body,
  :content_type,
  :accept,
  :model_id,
  :trace,
  :guardrail_identifier,
  :guardrail_version,
  :performance_config_latency)
  SENSITIVE = [:body]
  include Aws::Structure
end