Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Este guia o orienta na configuração e na realização de chamadas de API para Claude no Amazon Bedrock. Claude no Amazon Bedrock é executado em infraestrutura gerenciada pela AWS com acesso zero do operador (pessoal da Anthropic não tem acesso à infraestrutura de inferência), permitindo que você crie aplicações sensíveis inteiramente dentro do limite de segurança da AWS enquanto usa a mesma forma de API de Mensagens que você usa com a API de primeira parte da Anthropic.
Esta página cobre a visualização de pesquisa da nova oferta Claude no Amazon Bedrock, que expõe a API de Mensagens em /anthropic/v1/messages. Para a integração existente do Bedrock (as APIs InvokeModel e Converse com identificadores de modelo com versão ARN e codificação de fluxo de eventos da AWS), consulte Claude no Amazon Bedrock.
O endpoint Claude no Amazon Bedrock está em visualização de pesquisa, disponível na região US East (N. Virginia) us-east-1. Entre em contato com seu executivo de conta da Anthropic para solicitar acesso.
Antes de começar, certifique-se de que você tem:
us-east-1. A visualização de pesquisa requer uma conta dedicada para isolamento. Seu executivo de conta da Anthropic enviará seu ID de conta para a equipe do Bedrock Marketplace para colocação na lista de permissões (normalmente processado em 24 horas).Was this page helpful?
Claude no Amazon Bedrock suporta três caminhos de autenticação. Escolha o que melhor se adequa aos seus requisitos de segurança.
Use uma função de serviço Bedrock com chaves gerenciadas pela AWS para o acesso mais seguro e de longa duração:
Admin: provisionar a função de serviço
Um administrador da AWS provisiona uma função de serviço Bedrock e concede aos desenvolvedores permissão iam:PassRole no ARN da função de serviço.
Desenvolvedor: passar a função
Ao chamar a API, o Bedrock assume a função de serviço em seu nome. Consulte a documentação do Amazon Bedrock para saber como associar a função às suas solicitações.
Para acesso com identidade federada com sessão máxima de 12 horas:
Admin: configurar a função do IAM
Crie uma função do IAM com escopo para seus modelos Claude. A política de confiança nomeia seu provedor de identidade (SAML, OIDC ou AWS Identity Center). A política de permissões concede bedrock-mantle:CreateInference apenas nos ARNs de modelo permitidos.
Desenvolvedor: autenticar e assumir
Autentique-se através de seu provedor de identidade corporativo e assuma a função do IAM. O AWS STS emite credenciais temporárias que o SDK ou CLI usa para assinar solicitações.
Para acesso de curto prazo sem funções do IAM (máximo de 12 horas, menos preferido):
Admin: restringir tipos de token
Bloqueie chaves de longa duração anexando uma política que nega bedrock:CallWithBearerToken a menos que a condição bedrock:BearerTokenType corresponda a um token de curto prazo.
Desenvolvedor: cunhar um token
Use a CLI aws-bedrock-token-generator para cunhar um token de portador. Passe-o no cabeçalho x-api-key em cada solicitação.
Os SDKs de cliente da Anthropic suportam Claude no Amazon Bedrock através de um pacote ou módulo específico do Bedrock.
O endpoint segue o padrão https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Diferentemente da integração baseada em InvokeModel, este endpoint usa streaming SSE padrão e a mesma forma de corpo de solicitação que a API de primeira parte da Anthropic.
O SDK resolve credenciais e região usando a precedência padrão da AWS: argumentos do construtor, depois variáveis de ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), depois o arquivo de configuração da AWS e a cadeia de credenciais (SSO, funções assumidas, função de tarefa ECS, IMDS).
Você também pode usar o cliente Anthropic padrão: defina base_url como https://bedrock-mantle.{region}.api.aws/anthropic e passe seu token de portador como api_key. Este caminho suporta apenas autenticação de token de portador. A assinatura SigV4 requer o cliente dedicado.
IDs de modelo em Claude no Amazon Bedrock carregam um prefixo de provedor anthropic.. As capacidades e comportamentos do modelo estão documentados na página Visão geral de modelos.
| Modelo | ID do Modelo |
|---|---|
| Claude Opus 4.7 | anthropic.claude-opus-4-7 |
| Claude Mythos Preview | anthropic.claude-mythos-preview |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5 |
Claude no Amazon Bedrock suporta recursos que são executados dentro do modelo. Recursos que requerem infraestrutura operada pela Anthropic não estão disponíveis.
Suportado:
/v1/messages)Não suportado:
/v1/usersA visualização de pesquisa está disponível apenas em us-east-1 (IAD).
A cota padrão é de 2 milhões de tokens de entrada por minuto (TPM). Você pode solicitar até 4 milhões de TPM de entrada sem aprovação adicional da Anthropic. A AWS impõe limites de solicitações por minuto (RPM) no lado do Bedrock; entre em contato com o suporte da AWS para ajustes de RPM.
O tratamento de dados para esta oferta é governado pelo Amazon Bedrock. Para detalhes, consulte Proteção de dados no Amazon Bedrock.
Retenção zero de dados (ZDR) está disponível. Para ativar o ZDR em sua conta, entre em contato com o suporte da AWS.
Claude no Amazon Bedrock emite logs para CloudWatch e CloudTrail. A Anthropic recomenda reter logs de atividade em pelo menos uma base de rolagem de 30 dias para entender padrões de uso e investigar possíveis problemas.
Para suporte de visualização de pesquisa, entre em contato com [email protected]. Inclua seu ID de conta da AWS e o request-id de qualquer resposta de API com falha.
Claude Mythos Preview é um modelo de visualização de pesquisa disponível para clientes convidados no Amazon Bedrock. Para mais informações, consulte Project Glasswing.