Claude en Amazon Bedrock

Amazon Bedrock (heredado)

Esta página cubre la integración de Amazon Bedrock disponible hoy (las APIs InvokeModel y Converse con identificadores de modelo con versión ARN y codificación de flujo de eventos de AWS). Una vista previa de investigación de una nueva oferta administrada por AWS, con la API de Mensajes en /anthropic/v1/messages y transmisión SSE, se documenta en Claude en Amazon Bedrock (vista previa de investigación).

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 guía a través de completar una llamada a la API a Claude en Bedrock usando 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.

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.

Acceder 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 del modelo 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

Claude Opus 4.7 está disponible en AWS a través de Claude en Amazon Bedrock, actualmente en vista previa de investigación. No está disponible a través del catálogo de modelos estándar de Bedrock documentado en esta página.

Modelo	ID de modelo base de Bedrock	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1	Sí	Sí	Sí	Sí	Sí
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Sí	Sí	Sí	Sí	No
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Sí

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:

Realizar solicitudes

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.

Autenticación con token portador

Puedes autenticarte con Bedrock usando tokens portadores 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.

La autenticación con token portador es compatible con los SDK de C#, Go y Java. Los SDK de PHP, Python, TypeScript y Ruby usan solo la firma SigV4 de AWS.

El enfoque más simple es establecer la variable de entorno AWS_BEARER_TOKEN_BEDROCK, que es detectada automáticamente por la resolución de credenciales fromEnv().

Para proporcionar un token mediante programación:

Registro de actividad

Bedrock proporciona un servicio de registro de invocación que permite a los clientes registrar los mensajes 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 ni a Anthropic acceso a tu contenido.

Soporte de características

Para todas las características actualmente soportadas en Bedrock, consulta descripción general de características de API.

Soporte de PDF en Bedrock

El soporte de PDF está disponible en Amazon Bedrock a través de la API Converse y la API InvokeModel. 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

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

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

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 (deprecado), Opus 4 (deprecado) 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 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 tráfico a través de regiones geográficas específicas
Requerido para requisitos de residencia de datos y cumplimiento
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 Opus 4.6, Sonnet 4.5 y Sonnet 4 (deprecado)):

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

Usando puntos finales regionales (CRIS):

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

Claude Mythos Preview es un modelo de vista previa de investigación disponible para clientes invitados en Amazon Bedrock. Para obtener más información, consulta Project Glasswing.

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

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(
    # 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-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-east-1",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

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 punto final regional de EE.UU. (CRIS)
message = client.messages.create(
    model="anthropic.claude-opus-4-6-v1",  # Sin prefijo global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)