View a markdown version of this page

API 入門 - Amazon Nova
取得憑證以授予程式設計存取權將 Amazon Bedrock 許可連接至使用者或角色使用 Amazon Nova 模型為文字提示詞產生回應

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

API 入門

開始使用 APIs 之前，如果您剛開始使用 AWS 或需要安裝 AWS CLI 或 AWS SDK，請遵循這些程序。如果兩者都不適用於您，請移至 取得憑證以授予程式設計存取權。

如果您沒有 AWS 帳戶，請完成下列步驟來建立帳戶。或者，您也可以前往 nova.amazon.com/dev：// 開始使用 Amazon Nova 免費建置。

註冊 AWS 帳戶

  1. 開啟 https://portal.aws.amazon.com/billing/signup。

  2. 請遵循線上指示進行。

    部分註冊程序需接收來電或簡訊，並在電話鍵盤輸入驗證碼。

    當您註冊 AWS 帳戶時，會建立 AWS 帳戶根使用者。根使用者有權存取該帳戶中的所有 AWS 服務和資源。作為安全最佳實務，將管理存取權指派給使用者，並僅使用根使用者來執行需要根使用者存取權的任務。

AWS 會在註冊程序完成後傳送確認電子郵件給您。您可以隨時登錄 https://aws.amazon.com/ 並選擇我的帳戶，以檢視您目前的帳戶活動並管理帳戶。

保護 AWS 您的帳戶根使用者

  1. 選擇根使用者並輸入 AWS 您的帳戶電子郵件地址，以帳戶擁有者AWS 管理主控台身分登入 。在下一頁中，輸入您的密碼。

    如需使用根使用者登入的說明，請參閱 登入使用者指南中的以根使用者身分AWS 登入。

  2. 若要在您的根使用者帳戶上啟用多重要素驗證 (MFA)。

    如需說明，請參閱《IAM 使用者指南》中的為 AWS 您的帳戶根使用者 （主控台） 啟用虛擬 MFA 裝置。

若要安裝 AWS CLI，請遵循安裝或更新至最新版本 CLI AWS中的步驟。

若要安裝 AWS SDK，請選取對應至您要在 Tools to Build on AWS中使用的程式設計語言的標籤。

AWS 軟體開發套件 (SDKs) 適用於許多熱門的程式設計語言。每個 SDK 都提供 API、程式碼範例和文件，可讓開發人員更輕鬆地以他們偏好的語言建置應用程式。SDK 會自動為您執行有用的任務，例如：

  • 加密簽署服務請求

  • 重試請求

  • 處理錯誤回應

取得憑證以授予程式設計存取權

如果使用者想要在 AWS 管理主控台 AWS 外部與 互動，則需要程式設計存取。授予程式設計存取權的方式取決於正在存取的使用者類型 AWS。

若要授與使用者程式化存取權，請選擇下列其中一個選項。

哪個主體需要程式設計存取權？ 到 根據
IAM 使用者 限制長期憑證的持續時間，以簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請依照您要使用的介面所提供的指示操作。
IAM 角色 使用臨時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請遵循《IAM 使用者指南》中將臨時登入資料與 AWS 資源搭配使用中的指示。
在 IAM Identity Center 中管理的使用者 使用臨時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請依照您要使用的介面所提供的指示操作。

將 Amazon Bedrock 許可連接至使用者或角色

設定程式設計存取的登入資料後，您需要設定使用者或 IAM 角色的許可，才能存取 Amazon Bedrock 相關動作。若要設定這些許可，請執行下列動作：

  1. 在 AWS 管理主控台首頁上，選取 IAM 服務或導覽至位於 https：//https://console.aws.amazon.com/iam/ 的 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"}}'