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

# API 入門
<a name="getting-started-api"></a>

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

## 我第一次使用 AWS
<a name="new-to-aws"></a>

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

**註冊 AWS 帳戶**

1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。

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

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

   當您註冊 AWS 帳戶時，會建立 *AWS 帳戶根使用者*。根使用者有權存取該帳戶中的所有 AWS 服務和資源。作為安全最佳實務，將管理存取權指派給使用者，並僅使用根使用者來執行[需要根使用者存取權的任務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。

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

**保護 AWS 您的帳戶根使用者**

1. 選擇**根使用者**並輸入 AWS 您的帳戶電子郵件地址，以帳戶擁有者[AWS 管理主控台](https://console.aws.amazon.com/)身分登入 。在下一頁中，輸入您的密碼。

   如需使用根使用者登入的說明，請參閱 [登入使用者指南中的以根使用者身分](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)*AWS 登入*。

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

   如需說明，請參閱《*IAM 使用者指南*》中的[為 AWS 您的帳戶根使用者 （主控台） 啟用虛擬 MFA 裝置](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html)。

## 我需要安裝 AWS CLI 或 AWS SDK
<a name="install-cli-sdk"></a>

若要安裝 AWS CLI，請遵循[安裝或更新至最新版本 CLI AWS](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)中的步驟。

若要安裝 AWS SDK，請選取對應至您要在 [Tools to Build on AWS](https://aws.amazon.com/developer/tools/)中使用的程式設計語言的標籤。

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

## 取得憑證以授予程式設計存取權
<a name="grant-program-access"></a>

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

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


| 哪個主體需要程式設計存取權？ | 到 | 根據 | 
| --- | --- | --- | 
| IAM 使用者 | 限制長期憑證的持續時間，以簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs | 請依照您要使用的介面所提供的指示操作。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/nova/latest/nova2-userguide/getting-started-api.html)  | 
| IAM 角色 | 使用臨時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs | 請遵循《IAM 使用者指南》中將[臨時登入資料與 AWS 資源搭配使用](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)中的指示。 | 
| 在 IAM Identity Center 中管理的使用者 | 使用臨時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs | 請依照您要使用的介面所提供的指示操作。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/nova/latest/nova2-userguide/getting-started-api.html)  | 

## 將 Amazon Bedrock 許可連接至使用者或角色
<a name="attach-permissions"></a>

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

1. 在 AWS 管理主控台首頁上，選取 IAM 服務或導覽至位於 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 的 IAM 主控台。

1. 選取**使用者**或**角色**，然後選取您的使用者或角色。

1. 在**許可**索引標籤中，選擇**新增許可**，然後選擇**新增 AWS 受管政策**。選擇 [AmazonBedrockFullAccess](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonBedrockFullAccess) AWS 受管政策。

1. 若要允許使用者或角色訂閱模型，請選擇**建立內嵌政策**，然後在 JSON 編輯器中指定下列許可：

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

## 使用 Amazon Nova 模型為文字提示詞產生回應
<a name="generate-response"></a>

滿足所有先決條件後，您可以使用 [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 請求測試對 Amazon Nova 模型提出模型調用請求。

若要安裝 AWS CLI，請依照[安裝或更新至最新版本的 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 中的步驟進行。遵循 [取得憑證以授予程式設計存取權](#grant-program-access) 中的步驟，確認您已設定憑證來使用 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"}}'
```