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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) mediante Python. Esta es la forma más rápida de empezar a experimentar con Amazon Bedrock sin tener que configurar credenciales complejas AWS . **aviso** Las claves de API de larga duración 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys), 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 Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. En el panel de navegación izquierdo, seleccione **Claves de API**. 1. En la pestaña **Claves de API de larga duración**, seleccione **Generar claves de API de larga duración**. 1. En la sección **Caducidad de la clave de API**, seleccione **30 días**. 1. 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](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockLimitedAccess)política adjunta. 1. 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. 1. Configure la clave de API como una variable de entorno {{${api-key}}} sustituyéndola por el valor de clave de API generado y utilícela para generar una respuesta según el método que prefiera: ------ #### [ 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 más acciones de Amazon Bedrock, debería pasar a métodos de autenticación más seguros, como las claves de API de Amazon Bedrock a corto plazo o las credenciales temporales para AWS todo el mundo. 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](foundation-models-reference.md) 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 [Envío de solicitudes y generación de respuestas con inferencia de modelos](inference.md). + **Planifique la producción con métodos de autenticación más seguros**: lea más detalladamente sobre las claves de API de Amazon Bedrock en el capítulo Creación y sobre cómo crear claves de API de Amazon Bedrock más seguras y a corto plazo. Cuando esté listo para crear aplicaciones de producción, también debería revisar las [alternativas a las claves de acceso a largo plazo](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds-programmatic-access.html#security-creds-alternatives-to-long-term-access-keys) para obtener opciones más seguras que también permitan el acceso a otros AWS servicios.