View a markdown version of this page

Introducción a las claves de API de Amazon Bedrock: generación de una clave de 30 días y ejecución de una primera llamada a la API - Amazon Bedrock

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción a las claves de API de Amazon Bedrock: generación de una clave de 30 días y ejecución de una primera llamada a la API

En este tutorial, se explica cómo crear una clave de API de Amazon Bedrock de larga duración que caduca a los 30 días y cómo utilizarla para realizar una llamada sencilla a la API Converse mediante Python. Esta es la forma más rápida de empezar a experimentar con Amazon Bedrock sin necesidad de configurar credenciales complejas AWS .

aviso

Long-term Las claves de API solo se recomiendan para la exploración y el desarrollo de Amazon Bedrock. Para las aplicaciones de producción, utilice alternativas a las claves de acceso de larga duración, como roles de IAM o credenciales temporales.

Siga estos pasos para crear una clave de API de Amazon Bedrock de larga duración que caduque a los 30 días:

  1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en. https://console.aws.amazon.com/bedrock

  2. En el panel de navegación izquierdo, seleccione Claves de API.

  3. En la pestaña de claves de Long-term API, elija Generar claves de API a largo plazo.

  4. En la sección Caducidad de la clave de API, seleccione 30 días.

  5. Seleccione Generar. La clave que genere proporciona permisos para llevar a cabo las principales acciones de Amazon Bedrock, tal y como se define en la AmazonBedrockLimitedAccess política adjunta.

  6. Copie la clave de API generada y almacénela de forma segura. La necesitará para el siguiente paso.

    importante

    La clave de API solo se muestra una vez. Asegúrese de copiarla y guardarla antes de cerrar el cuadro de diálogo. Recuerde que su clave de API caducará en 30 días. Puede generar una nueva siguiendo los mismos pasos o considerar la posibilidad de utilizar métodos de autenticación más seguros para un uso continuado.

  7. Configure la clave de API como variable de entorno sustituyéndola por el valor de la clave de API que haya generado y utilícela para generar una respuesta ${api-key} con el método que elija:

    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"}]
        }
    ]
  }'

¡Enhorabuena! Ha generado correctamente una clave de API de Amazon Bedrock y ha realizado su primera llamada de API al servicio de Amazon Bedrock. Tras explorar otras acciones de Amazon Bedrock, debería hacer la transición a métodos de autenticación más seguros, como las claves de API de Amazon Bedrock a corto plazo o las credenciales temporales AWS generales. Para obtener más información consulte los siguientes recursos:

  • Explore diferentes modelos: obtenga información sobre otros modelos fundacionales disponibles en Amazon Bedrock en Uso de modelos con Bedrock y cambie el model_id en su código para probarlos.

  • Obtenga información sobre la inferencia de modelos: obtenga información sobre cómo generar respuestas con la inferencia de modelos consultando los conceptos y las opciones disponibles en Amazon Bedrock en Realizar solicitudes de inferencia.

  • Planifique la producción con métodos de autenticación más seguros. Lea sobre las claves de API de Amazon Bedrock en el capítulo Build, donde encontrará información sobre cómo crear claves de API de Amazon Bedrock más seguras y a corto plazo. En el caso de las aplicaciones de producción, revise las alternativas a las claves de acceso a largo plazo para encontrar opciones más seguras que también permitan el acceso a otros AWS servicios.