# API 시작하기
<a name="getting-started-api"></a>

API를 시작하기 전에 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 Management Console](https://console.aws.amazon.com/)에 계정 소유자로 로그인하세요. 다음 페이지에서 비밀번호를 입력합니다.

   루트 사용자를 사용하여 로그인하는 데 도움이 필요하면 *AWS 로그인 사용 설명서*의 [Signing in as the root user](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)을 참조하세요.

1. 루트 사용자의 다중 인증(MFA)을 활성화합니다.

   지침은 *IAM 사용 설명서*의 [AWS 계정 루트 사용자용 가상 MFA 디바이스 활성화(콘솔)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html)를 참조하세요.

## AWS 또는 AWS SDK를 설치해야 하는 경우
<a name="install-cli-sdk"></a>

AWS CLI를 설치하려면 [최신 버전의 AWS CLI 설치 또는 업데이트](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)에 나와 있는 단계를 따르세요.

AWS SDK를 설치하려면 [AWS에서 빌드에 사용할 도구](https://aws.amazon.com/developer/tools/)에서 사용하려는 프로그래밍 언어에 해당하는 탭을 선택하세요.

다양한 프로그래밍 언어에 대해 AWS 소프트웨어 개발 키트(SDK)를 사용할 수 있습니다. 각 SDK는 개발자가 선호하는 언어로 애플리케이션을 쉽게 구축할 수 있도록 하는 API, 코드 예제 및 설명서를 제공합니다. SDK는 다음과 같은 유용한 작업을 자동으로 수행합니다.
+ 서비스 요청에 대한 암호화 서명
+ 요청 재시도
+ 오류 응답 처리

## 프로그래밍 방식 액세스 권한을 부여하는 자격 증명 가져오기
<a name="grant-program-access"></a>

사용자가 AWS Management Console 외부에서 AWS와 상호 작용하려면 프로그래밍 방식의 액세스 권한이 필요합니다. 프로그래밍 방식으로 액세스 권한을 부여하는 방법은 AWS에 액세스하는 사용자 유형에 따라 다릅니다.

사용자에게 프로그래밍 방식의 액세스 권한을 부여하려면 다음 옵션 중 하나를 선택합니다.


| 프로그래밍 방식 액세스가 필요한 위탁자는 누구인가요? | 목적 | 방법 | 
| --- | --- | --- | 
| IAM 사용자 | 장기 자격 증명의 기간을 제한하여 AWS CLI, AWS SDK 또는 AWS API에 대한 프로그래밍 요청에 서명합니다. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/nova/latest/nova2-userguide/getting-started-api.html)  | 
| IAM 역할 | 임시 자격 증명을 사용하여 AWS CLI, AWS SDK 또는 AWS API에 대한 프로그래밍 요청에 서명합니다. | IAM 사용자 안내서의 [AWS 리소스와 함께 임시 자격 증명 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)에 나와 있는 지침을 따릅니다. | 
| IAM Identity Center에서 관리되는 사용자 | 임시 자격 증명을 사용하여 AWS CLI, AWS SDK 또는 AWS API에 대한 프로그래밍 요청에 서명합니다. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/nova/latest/nova2-userguide/getting-started-api.html)  | 

## 사용자 또는 역할에 Amazon Bedrock 권한 연결
<a name="attach-permissions"></a>

프로그래밍 방식 액세스를 위한 자격 증명을 설정한 후에는 사용자 또는 IAM 역할이 Amazon Bedrock 관련 작업에 액세스할 수 있도록 권한을 구성해야 합니다. 이러한 권한을 설정하려면 다음을 수행하세요.

1. AWS Management Console 홈페이지에서 IAM 서비스를 선택하거나 [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"}}'
```