Claude en Amazon Bedrock (legado)

Llamar a Claude a través de Bedrock difiere ligeramente de cómo llamarías a Claude directamente en la API de Claude. Esta guía te acompaña en la realización de una llamada a la API de Claude en Bedrock usando uno de los SDKs de cliente de Anthropic.

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.



Instala y configura la AWS CLI

1. Instala una versión de la AWS CLI igual o más reciente que la versión 2.13.23
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 AWS y siguiendo las instrucciones del modal emergente.
3. Verifica que tus credenciales funcionan:

aws sts get-caller-identity



Instala un SDK para acceder a Bedrock

Los SDKs de cliente de Anthropic son compatibles con Bedrock. También puedes usar un SDK de AWS como boto3 directamente.



Acceder a Bedrock



Suscríbete a los modelos de Anthropic

Ve a la Consola de AWS > Bedrock > Model Access y solicita acceso a los modelos de Anthropic. Ten en cuenta que la disponibilidad de los 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 la API

Los términos del ciclo de vida (Obsoleto, Retirado) se definen en Obsolescencia de modelos. Las fechas del ciclo de vida en las plataformas operadas por socios las establece el socio y pueden diferir del calendario de la API de Claude. Para la fecha de retiro actual de cualquier modelo en Amazon Bedrock, consulta la página del ciclo de vida de modelos de Amazon Bedrock.

Para obtener más información sobre los IDs de modelo regionales frente a los globales, consulta la sección Endpoints globales vs regionales.



Lista los modelos disponibles

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

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])



Realizar solicitudes

Los siguientes ejemplos muestran cómo generar texto con 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>",
    # Se pueden usar credenciales temporales 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 envía la solicitud. Por defecto, el SDK lee AWS_REGION,
    # y si no está presente, usa us-east-1 por defecto. Ten en cuenta que el SDK no lee ~/.aws/config para la región.
    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 los SDKs de cliente para obtener más detalles, y la documentación oficial de Bedrock.



Autenticación con token bearer

Puedes autenticarte con Bedrock usando tokens bearer en lugar de credenciales de AWS. Esto es útil en entornos corporativos donde los equipos necesitan acceso a Bedrock sin gestionar credenciales de AWS, roles de IAM o permisos a nivel de cuenta.

El enfoque más simple es establecer la variable de entorno AWS_BEARER_TOKEN_BEDROCK, que cada SDK detecta automáticamente al resolver las credenciales desde el entorno.

Para proporcionar un token de forma programática:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

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



Registro de actividad

Bedrock proporciona un servicio de registro de invocaciones que permite a los clientes registrar los prompts y las finalizaciones asociadas con tu uso.

Anthropic recomienda que registres tu actividad al menos de forma continua durante 30 días para comprender tu actividad e investigar cualquier posible uso indebido.



Compatibilidad de funciones

Para la lista completa de funciones con disponibilidad en Amazon Bedrock, consulta la Descripción general de funciones.



Funciones compatibles destacadas

• Messages API
• Almacenamiento en caché de prompts
• Pensamiento extendido
• Uso de herramientas, incluyendo la herramienta Bash, la herramienta de uso de computadora, la herramienta de memoria y la herramienta de editor de texto
• Citas
• Salidas estructuradas



Funciones no compatibles

• Fuentes de entrada (fuentes URL para imágenes y documentos, Files API)
• Herramientas del lado del servidor (ejecución de código, búsqueda web, obtención web, advisor)
• Infraestructura de agentes (Agent Skills, conector MCP, llamadas programáticas a herramientas)
• Endpoints de la API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Respaldo del lado del servidor (el parámetro fallbacks; usa en su lugar el patrón de respaldo del lado del cliente)



Compatibilidad con PDF en Bedrock

La compatibilidad con PDF está disponible en Bedrock tanto a través de la Converse API como de la InvokeModel API. Para obtener información detallada sobre las capacidades y limitaciones del procesamiento de PDF, consulta Compatibilidad con PDF en Amazon Bedrock.

Consideraciones importantes para los usuarios de la Converse API:

• 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 un control total sin citas forzadas, usa la InvokeModel API



Ventana de contexto

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6 y Claude Sonnet 4.6 tienen una ventana de contexto de 1M de tokens en Amazon Bedrock. Otros modelos de Claude, incluidos Sonnet 4.5 y Sonnet 4 (obsoleto), tienen una ventana de contexto de 200k tokens.

Bedrock limita las cargas útiles de las solicitudes a 20 MB. Al enviar documentos grandes o muchas imágenes, puedes alcanzar este límite antes que el límite de tokens.



Endpoints globales vs regionales

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

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

Los endpoints regionales incluyen un recargo del 10% en el precio sobre los endpoints globales.



Cuándo usar cada opción

Endpoints globales (recomendado):

• Proporcionan máxima disponibilidad y tiempo de actividad
• Enrutan dinámicamente las solicitudes a regiones con capacidad disponible
• Sin recargo en el precio
• Ideal para aplicaciones donde la residencia de datos es flexible

Endpoints regionales (CRIS):

• Enrutan el tráfico a través de regiones geográficas específicas
• Requeridos para requisitos de residencia de datos y cumplimiento
• Disponibles para EE. UU., UE, Japón y Asia-Pacífico
• El recargo del 10% en el precio refleja los costos de infraestructura para la capacidad regional dedicada



Implementación

Uso de endpoints globales (predeterminado para Opus 4.6, Sonnet 4.6 y Sonnet 4.5):

Los IDs de modelo para Claude Opus 4.6, Sonnet 4.6 y Sonnet 4.5 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"}],
)

Uso de endpoints regionales (CRIS):

Para usar endpoints regionales, reemplaza el prefijo global. con un prefijo regional como us.:

from anthropic import AnthropicBedrock

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

# Usando el endpoint regional de EE. UU. (CRIS)
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)



Recursos adicionales

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