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 muestra cómo completar una llamada de API a Claude en Bedrock utilizando uno de los SDK 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.
2.13.23.aws sts get-caller-identityLos SDK de cliente de Anthropic son compatibles con Bedrock. También puedes usar un SDK de AWS como boto3 directamente.
Ve a AWS Console > 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.
Los términos del ciclo de vida (Obsoleto, Retirado) se definen en Obsolescencia de modelos. Las fechas del ciclo de vida en plataformas operadas por socios las establece el socio y pueden diferir del calendario de la API de Claude. Para conocer la fecha de retiro actual de cualquier modelo en Amazon Bedrock, consulta la página de ciclo de vida de modelos de Amazon Bedrock.
AWS ofrece los modelos más recientes de Claude a través de inferencia entre regiones en lugar de rendimiento bajo demanda. Para estos modelos, una solicitud que pasa el ID de modelo base falla con un error HTTP 400 como el siguiente:
Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.Para invocar estos modelos, pasa un perfil de inferencia en lugar del ID de modelo base. El ID del perfil de inferencia es el ID de modelo base con un prefijo de una columna marcada como "Sí" en la siguiente tabla, por ejemplo . También puedes pasar el ARN completo del perfil de inferencia, con el formato arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}. Para la lista autorizada de AWS de perfiles de inferencia disponibles, consulta Regiones y modelos compatibles para perfiles de inferencia. Para saber cómo los prefijos afectan el enrutamiento y los precios, consulta la sección Endpoints globales versus regionales.
| Modelo | ID de modelo base de Bedrock | global | us | eu | jp | apac |
|---|---|---|---|---|---|---|
| Claude Opus 4.6 | Sí | Sí | Sí | Sí | Sí | |
| Claude Sonnet 4.6 | Sí | Sí | Sí | Sí | No | |
| Claude Sonnet 4.5 | Sí | Sí | Sí |
Los siguientes ejemplos muestran cómo imprimir una lista de todos los modelos de Claude disponibles a través de Bedrock:
Los siguientes ejemplos muestran cómo generar texto desde Claude en Bedrock:
Consulta los SDK de cliente para obtener más detalles, y la documentación oficial de Bedrock.
Puedes autenticarte con Bedrock usando tokens de portador (bearer tokens) 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 credenciales desde el entorno.
Para proporcionar un token de forma programática:
Bedrock proporciona un servicio de registro de invocaciones que te permite registrar los prompts y las respuestas 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.
Para ver la lista completa de funciones con disponibilidad en Amazon Bedrock, consulta Descripción general de funciones.
fallbacks; usa el patrón de fallback del lado del cliente en su lugar)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 usuarios de la Converse API:
Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 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.
A partir de Claude Sonnet 4.5 y todos los modelos futuros, Bedrock ofrece dos tipos de endpoints:
Los endpoints regionales incluyen un recargo de precio del 10% sobre los endpoints globales.
Endpoints globales (recomendado):
Endpoints regionales (CRIS):
Uso de endpoints globales (predeterminado para Opus 4.6, Sonnet 4.6 y Sonnet 4.5):
Los ID de modelo para Claude Opus 4.6, Sonnet 4.6 y Sonnet 4.5 ya incluyen el prefijo global.:
Uso de endpoints regionales (CRIS):
Para usar endpoints regionales, reemplaza el prefijo global. con un prefijo regional como us.:
Was this page helpful?
pip install -U "anthropic[bedrock]"| Sí |
| No |
| Claude Sonnet 4 Obsoleto. | Sí | Sí | Sí | No | Sí |
| Claude Sonnet 3.7 Retirado. | No | No | No | No | No |
| Claude Opus 4.5 | Sí | Sí | Sí | No | No |
| Claude Opus 4.1 Obsoleto. | No | Sí | No | No | No |
| Claude Opus 4 Retirado. | No | No | No | No | No |
| Claude Haiku 4.5 | Sí | Sí | Sí | No | No |
| Claude Haiku 3.5 Obsoleto. | No | Sí | No | No | No |
import boto3
bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")
for summary in response["modelSummaries"]:
print(summary["modelId"])from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Autentícate proporcionando las claves a continuación o usa los proveedores de credenciales predeterminados de AWS, como
# el archivo ~/.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. De forma predeterminada, el SDK lee AWS_REGION,
# y si no está presente, usa us-east-1. Ten en cuenta que el SDK no lee ~/.aws/config para obtener 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)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)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"}],
)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"}],
)