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. Tenga en cuenta que esta guía asume que ya se ha registrado en una cuenta de AWS y ha configurado el acceso programático.

Instalar y configurar la AWS CLI

  1. Instale una versión de la AWS CLI en la versión 2.13.23 o más reciente
  2. Configure sus credenciales de AWS usando el comando AWS configure (consulte Configurar la AWS CLI) o encuentre sus credenciales navegando a “Acceso de línea de comandos o acceso programático” dentro de su panel de AWS y siguiendo las instrucciones en la ventana modal emergente.
  3. Verifique que sus credenciales funcionan:
Shell
aws sts get-caller-identity

Instalar un SDK para acceder a Bedrock

Los SDK de cliente de Anthropic admiten Bedrock. También puede usar un SDK de AWS como boto3 directamente.
pip install -U "anthropic[bedrock]"

Acceder a Bedrock

Suscribirse a modelos de Anthropic

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

ID de modelos de API

ModeloID de modelo base de Bedrockglobaluseujpapac
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0Copied!No
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0Copied!No
Claude Sonnet 3.7 anthropic.claude-3-7-sonnet-20250219-v1:0Copied!NoNo
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0Copied!NoNoNoNo
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0Copied!NoNoNoNo
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0Copied!NoNoNoNo
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0Copied!NoNo
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0Copied!NoNoNoNo
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0Copied!NoNo
Para obtener más información sobre ID de modelos regionales frente a globales, consulte la sección Puntos finales globales frente a 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"

Realizar solicitudes

Los siguientes ejemplos muestran cómo generar texto desde Claude en Bedrock:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentíquese proporcionando las claves a continuación o use 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.
    # Lea 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. De forma predeterminada, leemos AWS_REGION,
    # y si eso no está presente, por defecto es us-east-1. Tenga 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)
Consulte 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 indicadores y las finalizaciones asociadas con su uso. Anthropic recomienda que registre su actividad al menos en una base móvil de 30 días para comprender su actividad e investigar cualquier posible mal uso.
Activar este servicio no le da a AWS ni a Anthropic acceso a su contenido.

Soporte de características

Puede encontrar todas las características actualmente admitidas 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, consulte 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 un control total sin citas forzadas, use la API InvokeModel
Para obtener más detalles sobre los dos modos de procesamiento de documentos y sus limitaciones, consulte la guía de soporte de PDF.

Ventana de contexto de 1M de tokens

Claude Sonnet 4 y 4.5 admiten la ventana de contexto de 1M de tokens en Amazon Bedrock.
La ventana de contexto de 1M de tokens está actualmente en versión beta. Para usar la ventana de contexto extendida, incluya el encabezado beta context-1m-2025-08-07 en sus solicitudes de API de Bedrock.

Puntos finales globales frente a 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 la capacidad regional dedicada

Implementación

Usando puntos finales globales (predeterminado para Sonnet 4.5 y 4): Los ID 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-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
Usando puntos finales regionales (CRIS): Para usar puntos finales regionales, elimine el prefijo global. del ID de modelo:
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"}]
)

Recursos adicionales