Amazon Bedrock API 키 사용 - Amazon Bedrock

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Bedrock API 키 사용

다음과 같은 방법으로 Amazon Bedrock API 키를 사용할 수 있습니다.

  • 환경 변수로 설정 - Amazon Bedrock 서비스는 AWS_BEARER_TOKEN_BEDROCK 환경 변수를 인식합니다. 키를 설정하는 옵션은 다음과 같습니다.

    • 터미널을 열어 설정합니다.

      • MacOS/Linux

        export AWS_BEARER_TOKEN_BEDROCK=${api-key}

      • (Windows):

        setx AWS_BEARER_TOKEN_BEDROCK "${api-key}"

    • API 요청을 하기 전에 코드에서 환경 변수로 설정합니다. 예를 들어, 요청을 하기 전에 다음 줄을 포함할 수 있습니다.

      • Python 

        import os                      
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

  • 요청에 지정 - 다음과 같은 방법으로 권한 부여 헤더에 Amazon Bedrock API 키를 포함할 수 있습니다($AWS_BEARER_TOKEN_BEDROCK을 실제 값으로 대체).

    • 직접 HTTP 요청에서 - 다음을 권한 부여 헤더로 포함합니다.

      Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK

    • 지원되는 SDK의 파라미터로 - 클라이언트를 설정할 때 파라미터에 값을 지정합니다. 예를 들어, OpenAI Python SDK로 클라이언트를 설정할 때 api_key 필드에서 지정할 수 있습니다.

참고

Amazon Bedrock API 키는 Amazon Bedrock 및 Amazon Bedrock 런타임 작업으로 제한됩니다. 다음 API 작업에서는 해당 기능을 사용할 수 없습니다.

API 키를 사용하여 응답을 생성하는 Converse 요청을 보내는 예제를 보려면 원하는 방법의 탭을 선택한 후 다음 단계를 따릅니다.

Python

다음 예제에서는 AWS SDK for Python (Boto3)을 사용하여 API 요청을 보내는 방법을 보여줍니다. API 키를 AWS_BEARER_TOKEN_BEDROCK 환경 변수로 아직 설정하지 않은 경우 다음 코드에서 ${api-key} 대신 지정합니다.

import os
import boto3
                        
# If you already set the API key as an environment variable, you can comment this line out                        
os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}"

# Create an Amazon Bedrock client
client = boto3.client(
    service_name="bedrock-runtime",
    region_name="us-east-1" # If you've configured a default region, you can omit this line
)

# Define the model and message
model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0"
messages = [{"role": "user", "content": [{"text": "Hello"}]}]

response = client.converse(
    modelId=model_id,
    messages=messages,
)
HTTP Client (requests package in Python)

사전 조건: 터미널을 열고 다음 명령을 실행하여 requests 패키지를 설치합니다.

python3 -m pip install requests

다음 예제에서는 HTTP 클라이언트를 사용하여 API 요청을 직접 보내는 방법을 보여줍니다. 헤더에 ${api-key}를 지정합니다.

import requests

url = "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse"

payload = {
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ${api-key}"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
HTTP request using cURL

다음 예제에서는 cURL을 사용하여 API 요청을 직접 보내는 방법을 보여줍니다. API 키를 AWS_BEARER_TOKEN_BEDROCK 환경 변수로 설정하지 않은 경우 예제에서 $AWS_BEARER_TOKEN_BEDROCK을 키의 리터럴 값으로 바꿔야 합니다.

curl -X POST "https://bedrock-runtime.us-east-1.amazonaws.com/model/us.anthropic.claude-3-5-haiku-20241022-v1:0/converse" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
  -d '{
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Hello"}]
        }
    ]
  }'