View a markdown version of this page

API 入门 - Amazon Nova
获取凭证来授予编程访问权限将 Amazon Bedrock 权限附加到用户或角色使用 Amazon Nova 模型生成对文本提示的回复

API 入门

在开始使用 API 之前，如果不熟悉 AWS 或需要安装 AWS CLI 或 AWS SDK，请按照以下步骤操作。如果这些情况皆不适用，请跳至获取凭证来授予编程访问权限。

如果您还没有 AWS 账户，请先创建一个再继续。或者，您也可以通过 Amazon Nova（网址：nova.amazon.com/dev）免费开始构建。

注册 AWS 账户

要开始使用 AWS，您需要 AWS 账户。有关创建 AWS 账户的信息，请参阅《AWS 账户管理 参考指南》中的 AWS 账户入门指南。

要安装 AWS CLI，请按照安装或升级到最新版本的 AWS CLI 中的步骤操作。

要安装 AWS SDK，请在 AWS 开发工具页面中选择与所用编程语言对应的选项卡。

AWS 软件开发工具包（SDK）适用于许多常用编程语言。每个 SDK 都提供 API、代码示例和文档，帮助开发人员更轻松地以其首选语言构建应用程序。SDK 会自动为您执行有用的任务，例如：

  • 对服务请求进行加密签名

  • 重试请求

  • 处理错误响应

获取凭证来授予编程访问权限

如果用户需要在 AWS 管理控制台之外与 AWS 交互，则需要编程式访问权限。授予编程式访问权限的方法取决于访问 AWS 的用户类型。

要向用户授予编程式访问权限，请选择以下选项之一。

哪个主体需要编程访问权限？ 目标 方式
IAM 用户 限制对 AWS CLI、AWS SDK 或 AWS API 的编程请求进行签名的长期凭证的有效时长。 按照您希望使用的界面的说明进行操作。
IAM 角色 使用临时凭证签署向 AWS CLI、AWS SDK 或 AWS API 发出的编程请求。 遵循《IAM 用户指南》中对 AWS 资源使用临时凭证的相关说明。
在 IAM Identity Center 中托管的用户 使用临时凭证签署向 AWS CLI、AWS SDK 或 AWS API 发出的编程请求。 按照您希望使用的界面的说明进行操作。

将 Amazon Bedrock 权限附加到用户或角色

在设置好编程访问凭证后，您需要为用户或 IAM 角色配置权限，以便其访问与 Amazon Bedrock 相关的操作。要设置这些权限，请执行以下操作：

  1. 在 AWS 管理控制台主页上，选择 IAM 服务或进入 IAM 控制台，网址为 https://console.aws.amazon.com/iam/。

  2. 选择用户或角色，然后选择您的用户或角色。

  3. 在权限选项卡中，选择添加权限，然后选择添加 AWS 托管式策略。选择 AmazonBedrockFullAccess AWS 托管式策略。

  4. 要允许用户或角色订阅模型，请选择创建内联策略，然后在 JSON 编辑器中指定以下权限：

    {
  "Version": "2012-10-17",	
  "Statement": [
    {
      "Sid": "MarketplaceBedrock",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Unsubscribe",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*"
    }
  ]
}

使用 Amazon Nova 模型生成对文本提示的回复

满足所有先决条件后，您可以测试通过 Converse 请求来调用 Amazon Nova 模型。

要安装 AWS CLI，请按照安装或升级到最新版本的 AWS CLI 中的步骤操作。按照获取凭证来授予编程访问权限中的步骤，验证是否已设置凭证来使用 Boto3。

要使用 AWS CLI 在 Nova 2 Lite 中生成对文本提示的响应，请在终端中运行以下命令：

aws bedrock-runtime converse \
  --model-id us.amazon.nova-2-lite-v1:0 \
  --messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \
  --additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'