Llamar a Claude a través de Bedrock difiere ligeramente de cómo llamarías a Claude cuando usas los SDK de cliente de Anthropic. Esta guía te llevará a través del proceso de completar una llamada API a Claude en Bedrock ya sea en Python o TypeScript.

Ten en cuenta que esta guía asume que ya te has registrado para una cuenta de AWS y has configurado el acceso programático.

Instalar y configurar la AWS CLI

  1. Instala una versión de la AWS CLI en la versión 2.13.23 o más reciente
  2. Configura tus credenciales de AWS usando el comando AWS configure (ver Configurar la AWS CLI) o encuentra tus credenciales navegando a “Acceso de línea de comandos o programático” dentro de tu panel de AWS y siguiendo las instrucciones en el modal emergente.
  3. Verifica que tus credenciales estén funcionando:
Shell
aws sts get-caller-identity

Instalar un SDK para acceder a Bedrock

Los SDK de cliente de Anthropic soportan Bedrock. También puedes usar un SDK de AWS como boto3 directamente.

pip install -U "anthropic[bedrock]"

Accediendo a Bedrock

Suscribirse a los modelos de Anthropic

Ve a la Consola de AWS > Bedrock > Acceso a Modelos y solicita acceso a los modelos de Anthropic. Ten en cuenta que la disponibilidad de modelos de Anthropic varía por región. Ver documentación de AWS para la información más reciente.

Nombres de modelos de API

ModeloNombre del modelo de API de Bedrock
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0
Claude Sonnet 3.5anthropic.claude-3-5-sonnet-20241022-v2:0
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3 anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

Listar modelos disponibles

Los siguientes ejemplos muestran cómo imprimir una lista de todos los modelos Claude disponibles a través de Bedrock:

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Haciendo solicitudes

Los siguientes ejemplos muestran cómo generar texto desde Claude en Bedrock:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentícate proporcionando las claves a continuación o usa los proveedores de credenciales predeterminados de AWS, como
    # usar ~/.aws/credentials o las variables de entorno "AWS_SECRET_ACCESS_KEY" y "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Las credenciales temporales se pueden usar con aws_session_token.
    # Lee más en https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region cambia la región de aws a la cual se hace la solicitud. Por defecto, leemos AWS_REGION,
    # y si eso no está presente, por defecto usamos us-east-1. Ten en cuenta que no leemos ~/.aws/config para la región.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="anthropic.claude-opus-4-1-20250805-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hola, mundo"}]
)
print(message.content)

Ver nuestros SDK de cliente para más detalles, y los documentos oficiales de Bedrock aquí.

Registro de actividad

Bedrock proporciona un servicio de registro de invocaciones que permite a los clientes registrar los prompts y completaciones asociados con su uso.

Anthropic recomienda que registres tu actividad al menos en una base rotativa de 30 días para entender tu actividad e investigar cualquier posible mal uso.

Activar este servicio no le da a AWS o Anthropic ningún acceso a tu contenido.

Soporte de características

Puedes encontrar todas las características actualmente soportadas en Bedrock aquí.

Soporte de PDF en Bedrock

El soporte de PDF está disponible en Amazon Bedrock a través tanto de la API Converse como de la API InvokeModel. Para información detallada sobre las capacidades y limitaciones del procesamiento de PDF, ver la documentación de soporte de PDF.

Consideraciones importantes para usuarios de la API Converse:

  • El análisis visual de PDF (gráficos, imágenes, diseños) requiere que las citas estén habilitadas
  • Sin citas, solo está disponible la extracción básica de texto
  • Para control completo sin citas forzadas, usa la API InvokeModel

Para más detalles sobre los dos modos de procesamiento de documentos y sus limitaciones, consulta la guía de soporte de PDF.

Ventana de contexto de 1M tokens

Claude Sonnet 4 soporta la ventana de contexto de 1M tokens en Amazon Bedrock.

La ventana de contexto de 1M tokens está actualmente en beta. Para usar la ventana de contexto extendida, incluye el encabezado beta context-1m-2025-08-07 en tus solicitudes de API de Bedrock.