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 작업에는 사용할 수 없습니다.

• InvokeModelWithBidirectionalStream.

• Amazon Bedrock용 에이전트 또는 Amazon Bedrock 런타임 API 작업용 에이전트.

• Amazon Bedrock용 데이터 자동화 또는 Amazon Bedrock 데이터 자동화 API 작업용 런타임.

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

Python

다음 예제에서는를 사용하여 API 요청을 보내는 방법을 보여줍니다 AWS SDK for Python (Boto3). 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"}]
        }
    ]
  }'