Claude di Amazon Bedrock (Opus 4.7 dan yang lebih baru)

Panduan ini memandu Anda dalam menyiapkan dan melakukan panggilan API ke Claude di Amazon Bedrock. Claude di Amazon Bedrock berjalan pada infrastruktur yang dikelola AWS dengan akses operator nol (personel Anthropic tidak memiliki akses ke infrastruktur inferensi), sehingga Anda dapat membangun aplikasi sensitif sepenuhnya di dalam batas keamanan AWS sambil menggunakan bentuk Messages API yang sama dengan yang Anda gunakan pada API pihak pertama Anthropic.

Akses

Amazon Bedrock menetapkan kriteria akses untuk setiap model Claude secara individual. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7, dan Claude Haiku 4.5 terbuka untuk semua pelanggan Amazon Bedrock. Untuk kriteria terkini model lainnya, periksa akses model Amazon Bedrock di konsol AWS. Claude Mythos Preview memerlukan undangan melalui Project Glasswing. Untuk ketersediaan region, lihat Region.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

• Akun AWS dengan akses model Amazon Bedrock yang diaktifkan untuk model Claude yang ingin Anda gunakan.
• AWS CLI yang terinstal dan terkonfigurasi (opsional, untuk manajemen kredensial).

Claude Mythos Preview juga memerlukan akun AWS khusus yang telah dimasukkan ke dalam allowlist oleh tim Bedrock Marketplace. Account executive Anthropic Anda dapat mengajukan ID akun Anda untuk dimasukkan ke allowlist (biasanya diproses dalam 24 jam), dan AWS akan mengirimkan email sambutan setelah prosesnya selesai.

Autentikasi

Claude di Amazon Bedrock mendukung tiga jalur autentikasi. Pilih yang paling sesuai dengan persyaratan keamanan Anda.

Service role Bedrock (direkomendasikan)

Gunakan service role Bedrock dengan kunci yang dikelola AWS untuk akses jangka panjang yang paling aman:

1. 1

   Admin: sediakan service role

   Administrator AWS menyediakan service role Bedrock dan memberikan izin iam:PassRole kepada developer pada ARN service role tersebut.

2. 2

   Developer: teruskan role

   Saat memanggil API, Bedrock mengambil (assume) service role tersebut atas nama Anda. Lihat dokumentasi Amazon Bedrock untuk cara mengaitkan role dengan permintaan Anda.

IAM assumed role

Untuk akses terfederasi identitas dengan sesi maksimum 12 jam:

1. 1

   Admin: konfigurasikan IAM role

   Buat IAM role yang dibatasi cakupannya pada model Claude Anda. Trust policy menyebutkan penyedia identitas Anda (SAML, OIDC, atau AWS Identity Center). Permissions policy memberikan bedrock-mantle:CreateInference hanya pada ARN model yang diizinkan.

2. 2

   Developer: autentikasi dan assume

   Lakukan autentikasi melalui penyedia identitas perusahaan Anda, lalu assume IAM role tersebut. AWS STS menerbitkan kredensial sementara yang digunakan SDK atau CLI untuk menandatangani permintaan.

Bearer token

Untuk akses jangka pendek tanpa IAM role (maksimum 12 jam, paling tidak disarankan):

1. 1

   Admin: batasi jenis token

   Blokir kunci jangka panjang dengan melampirkan policy yang menolak bedrock:CallWithBearerToken kecuali kondisi bedrock:BearerTokenType cocok dengan token jangka pendek.

2. 2

   Developer: buat token

   Gunakan CLI aws-bedrock-token-generator untuk membuat bearer token. Teruskan token tersebut dalam header x-api-key pada setiap permintaan.

Instal SDK

Client SDK Anthropic mendukung Claude di Amazon Bedrock melalui paket atau modul khusus Bedrock.

pip install -U "anthropic[bedrock]"

Membuat permintaan pertama Anda

Endpoint mengikuti pola https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Berbeda dengan integrasi berbasis InvokeModel, endpoint ini menggunakan streaming SSE standar dan bentuk body permintaan yang sama dengan API pihak pertama Anthropic.

SDK menyelesaikan kredensial dan region menggunakan urutan prioritas standar AWS: argumen konstruktor, lalu variabel lingkungan (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), lalu file konfigurasi AWS dan rantai kredensial (SSO, assumed role, ECS task role, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))

Model yang didukung

ID model di Claude di Amazon Bedrock memiliki prefiks penyedia anthropic.. Kemampuan dan perilaku model didokumentasikan di halaman Ikhtisar model.

Gunakan Claude Code 2.1.255 atau yang lebih baru dengan Claude Fable 5.1 di Amazon Bedrock; jalankan claude update untuk memperbarui.

Dukungan fitur

Untuk daftar fitur lengkap beserta ketersediaannya di Amazon Bedrock, lihat Ikhtisar fitur.

Sorotan fitur yang didukung

• Messages API (/anthropic/v1/messages)
• Caching prompt
• Thinking
• Penggunaan alat, termasuk alat Bash, alat Computer use, alat Memory, dan alat Text editor
• Sitasi

Fitur yang tidak didukung

• Output terstruktur
• Sumber input (sumber URL untuk gambar dan dokumen, Files API)
• Alat sisi server (eksekusi kode, pencarian web, web fetch, advisor)
• Infrastruktur agen (Agent Skills, konektor MCP, pemanggilan alat terprogram)
• Endpoint API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback sisi server (parameter fallbacks; gunakan pola fallback sisi klien sebagai gantinya)
• Toolset computer use dan browser use (computer_toolset_20260801 dan browser_toolset_20260801 saat ini tidak tersedia di Amazon Bedrock; versi beta alat computer use tetap tersedia)

Region

Claude di Amazon Bedrock tersedia di region AWS berikut. Amazon Bedrock menawarkan dua jenis endpoint:

• Global: perutean dinamis ke seluruh region yang tersedia untuk ketersediaan maksimum. Tanpa premi harga.
• Regional: endpoint diarahkan ke satu region AWS yang Anda tentukan, untuk persyaratan residensi data. Endpoint regional dikenakan premi harga 10% dibandingkan endpoint global. Untuk merutekan ke beberapa region dalam satu wilayah geografis, gunakan inference profile (US, EU, JP, atau AU). Region yang ditandai In-region only dalam tabel mendukung perutean langsung satu region tanpa inference profile.

Endpoint global tersedia untuk Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5, dan Claude Haiku 4.5. Untuk Claude Fable 5.1, endpoint regional saat ini hanya tersedia di us-east-1. Claude Mythos Preview hanya bersifat regional dan tersedia di us-east-1.

Kuota

Kuota default adalah 2 juta token input per menit (TPM). Anda dapat meminta hingga 5 juta TPM input dan 500.000 TPM output tanpa persetujuan tambahan dari Anthropic. AWS memberlakukan batas requests-per-minute (RPM) di sisi Bedrock; hubungi dukungan AWS untuk penyesuaian RPM.

Retensi data

Penanganan data untuk penawaran ini diatur oleh Amazon Bedrock. Untuk detailnya, lihat Perlindungan data di Amazon Bedrock.

Pemantauan dan logging

Claude di Amazon Bedrock mengirimkan log ke CloudWatch dan CloudTrail. Anthropic merekomendasikan untuk menyimpan log aktivitas setidaknya secara bergulir selama 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah.

Dukungan

Untuk dukungan, hubungi bedrock-ant-eap@amazon.com. Sertakan ID akun AWS Anda dan request-id dari respons API yang gagal.