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

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 (consulta Configurar la AWS CLI) o encuentra tus credenciales navegando a "Command line or programmatic access" dentro de tu panel de control de AWS y siguiendo las instrucciones en el modal emergente.
3. Verifica que tus credenciales funcionan:

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.

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

Para obtener más información sobre los 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 de 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:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Authenticate by either providing the keys below or use the default AWS credential providers, such as
    # using ~/.aws/credentials or the "AWS_SECRET_ACCESS_KEY" and "AWS_ACCESS_KEY_ID" environment variables.
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Temporary credentials can be used with aws_session_token.
    # Read more at https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region changes the aws region to which the request is made. By default, we read AWS_REGION,
    # and if that's not present, we default to us-east-1. Note that we do not read ~/.aws/config for the region.
    aws_region="us-west-2",
)

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

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.

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 básica de texto
• 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 Opus 4.6, Sonnet 4.5 y Sonnet 4 soportan la ventana de contexto de 1M de tokens en Amazon 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.

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 US, EU, 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 Opus 4.6, Sonnet 4.5 y Sonnet 4):

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

from anthropic import AnthropicBedrock

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

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

Usando puntos finales regionales (CRIS):

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

from anthropic import AnthropicBedrock

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

# Using US regional endpoint (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # No global. prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

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: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Detalles de precios de Anthropic: Documentación de precios