开始使用 Amazon Bedrock API 密钥:生成 30 天密钥并进行第一次 API 调用 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

开始使用 Amazon Bedrock API 密钥:生成 30 天密钥并进行第一次 API 调用

本教程将引导你创建一个 30 天后到期的长期 Amazon Bedrock API 密钥,并使用它使用 Python 进行简单的 C onverse API 调用。这是无需设置复杂 AWS 凭证即可开始试用 Amazon Bedrock 的最快方法。

警告

建议仅在探索和开发 Amazon Bedrock 时使用长期 API 密钥。对于生产应用程序,请使用长期访问密钥的替代方法,例如 IAM 角色或临时证书。

请按照以下步骤创建在 30 天后到期的长期 Amazon Bedrock API 密钥:

  1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS Management Console 然后,打开 Amazon Bedrock 控制台,网址为https://console.aws.amazon.com/bedrock/

  2. 在左侧导航窗格中,选择 API 密钥

  3. 在 “长期 API 密钥” 选项卡中,选择 “生成长期 API 密钥”。

  4. API 密钥到期时间部分中,选择 30 天

  5. 选择 生成。您生成的密钥提供执行核心 Amazon Bedrock 操作的权限,如所附AmazonBedrockLimitedAccess策略所定义。

  6. 复制生成的 API 密钥并将其安全存储。下一步你需要这个密钥。

    重要

    API 密钥仅显示一次。在关闭对话框之前,请务必将其复制并保存。请记住,您的 API 密钥将在 30 天后过期。您可以按照相同的步骤生成一个新的身份验证方法,也可以考虑过渡到更安全的身份验证方法以供持续使用。

  7. 将 API 密钥设置为环境变量,方法是将其${api-key}替换为生成的 API 密钥值,然后使用它以您选择的方法生成响应:

    Python
    import boto3 import os # Set the API key as an environment variable os.environ['AWS_BEARER_TOKEN_BEDROCK'] = "${api-key}" # Create the Bedrock client client = boto3.client( service_name="bedrock-runtime", region_name="us-east-1" ) # Define the model and message model_id = "us.anthropic.claude-3-5-haiku-20241022-v1:0" messages = [{"role": "user", "content": [{"text": "Hello! Can you tell me about Amazon Bedrock?"}]}] # Make the API call response = client.converse( modelId=model_id, messages=messages, ) # Print the response print(response['output']['message']['content'][0]['text'])
    HTTP client using Python
    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 -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 ${api-key}" \ -d '{ "messages": [ { "role": "user", "content": [{"text": "Hello"}] } ] }'

恭喜您!您已成功生成亚马逊 Bedrock API 密钥,并首次调用亚马逊 Bedrock 服务。在探索了更多的 Amazon Bedrock 操作之后,您应该过渡到更安全的身份验证方法,例如短期 Amazon Bedrock API 密钥或 AWS全局临时证书。要了解更多信息,请参阅以下资源: