Claude en Amazon Bedrock

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 guiará a través del proceso de completar una llamada a la API a Claude en Bedrock en Python o TypeScript.

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

Instalar y configurar la AWS CLI

Instala una versión de la AWS CLI en la versión 2.13.23 o más reciente
Configura tus credenciales de AWS usando el comando AWS configure (consulta Configurar la AWS CLI) o encuentra tus credenciales navegando a "Command line or programmatic access" dentro de tu panel de AWS y siguiendo las instrucciones en el modal emergente.
Verifica que tus credenciales funcionan:

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 modelos de Anthropic

Ve a AWS Console > Bedrock > Model Access y solicita acceso a los modelos de Anthropic. Ten en cuenta que la disponibilidad de modelos de Anthropic varía según la región. Consulta la documentación de AWS para obtener la información más reciente.

IDs de modelo de API

Modelo	ID de modelo base de Bedrock	`global`	`us`	`eu`	`jp`	`apac`
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Sí	Sí	Sí	Sí	No
Claude Sonnet 4	anthropic.claude-sonnet-4-20250514-v1:0	Sí	Sí	Sí	No	Sí
Claude Sonnet 3.7 ⚠️	anthropic.claude-3-7-sonnet-20250219-v1:0

Para obtener más información sobre IDs de modelo regionales versus globales, consulta la sección Puntos finales globales versus regionales a continuación.

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"

Realizando solicitudes

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

Consulta nuestros SDK de cliente para obtener más detalles, y la documentación oficial de Bedrock aquí.

Registro de actividad

Bedrock proporciona un servicio de registro de invocación que permite a los clientes registrar los prompts y completaciones asociados con tu uso.

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

Activar este servicio no le da a AWS o Anthropic 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 de la API Converse e InvokeModel API. Para obtener información detallada sobre las capacidades y limitaciones del procesamiento de PDF, consulta 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 de texto básica
Para control total sin citas forzadas, usa la API InvokeModel

Para obtener 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 de tokens

Claude Sonnet 4 y 4.5 soportan la ventana de contexto de 1M de tokens en Amazon Bedrock.

La ventana de contexto de 1M de 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.

Puntos finales globales versus regionales

A partir de Claude Sonnet 4.5 y todos los modelos futuros, Amazon Bedrock ofrece dos tipos de puntos finales:

Puntos finales globales: Enrutamiento dinámico para máxima disponibilidad
Puntos finales regionales: Enrutamiento de datos garantizado a través de regiones geográficas específicas

Los puntos finales regionales incluyen una prima de precios del 10% sobre los puntos finales globales.

Esto se aplica solo a Claude Sonnet 4.5 y modelos futuros. Los modelos más antiguos (Claude Sonnet 4, Opus 4 y anteriores) mantienen sus estructuras de precios existentes.

Cuándo usar cada opción

Puntos finales globales (recomendado):

Proporcionan máxima disponibilidad y tiempo de actividad
Enrutan dinámicamente las solicitudes a regiones con capacidad disponible
Sin prima de precios
Mejor para aplicaciones donde la residencia de datos es flexible

Puntos finales regionales (CRIS):

Enrutan el tráfico a través de regiones geográficas específicas
Requerido para requisitos de residencia de datos y cumplimiento normativo
Disponible para EE.UU., UE, Japón y Australia
La prima de precios del 10% refleja los costos de infraestructura para capacidad regional dedicada

Implementación

Usando puntos finales globales (predeterminado para Sonnet 4.5 y 4):

Los IDs de modelo para Claude Sonnet 4.5 y 4 ya incluyen el prefijo global.:

Usando puntos finales regionales (CRIS):

Para usar puntos finales regionales, elimina el prefijo global. del ID de modelo:

Recursos adicionales

Precios de AWS Bedrock: aws.amazon.com/bedrock/pricing
Documentación de precios de AWS: Guía de precios de Bedrock
Publicación de blog de AWS: Presentación de Claude Sonnet 4.5 en Amazon Bedrock
Detalles de precios de Anthropic: Documentación de precios

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentica proporcionando las claves a continuación o usa los proveedores de credenciales de AWS predeterminados, 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 que se realiza la solicitud. Por defecto, leemos AWS_REGION,
    # y si no está presente, por defecto es 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="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Usando el punto final regional de EE.UU. (CRIS)
message = client.messages.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",  # Sin prefijo global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)