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), memungkinkan Anda 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, 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 Amazon Bedrock model access di konsol AWS. Claude Mythos Preview memerlukan undangan; lihat Project Glasswing. Untuk ketersediaan region, lihat Region.



Prasyarat

Sebelum memulai, pastikan Anda memiliki:

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

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



Autentikasi

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



Bedrock service role (direkomendasikan)

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



IAM assumed roles

Untuk akses terfederasi identitas dengan sesi maksimum 12 jam:



Bearer token

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



Menginstal SDK

SDK klien 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. Tidak seperti 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 AWS standar: 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 membawa prefiks penyedia anthropic.. Kemampuan dan perilaku model didokumentasikan di halaman Ikhtisar model.



Dukungan fitur

Untuk daftar fitur lengkap dengan ketersediaan Amazon Bedrock, lihat Ikhtisar fitur.



Sorotan fitur yang didukung

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



Fitur yang tidak didukung

• Structured outputs
• Sumber input (sumber URL untuk gambar dan dokumen, Files API)
• Alat sisi server (code execution, web search, web fetch, advisor)
• Infrastruktur agen (Agent Skills, MCP connector, programmatic tool calling)
• 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)



Region

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

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

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



Kuota

Kuota default adalah 2 juta token input per menit (TPM). Anda dapat meminta hingga 4 juta TPM input tanpa persetujuan tambahan dari Anthropic. AWS memberlakukan batas permintaan per menit (RPM) di sisi Bedrock; hubungi dukungan AWS untuk penyesuaian RPM.



Retensi data

Penanganan data untuk penawaran ini diatur oleh Amazon Bedrock. Untuk detailnya, lihat Data protection in Amazon Bedrock.



Pemantauan dan logging

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



Dukungan

Untuk dukungan, hubungi [email protected]. Sertakan ID akun AWS Anda dan request-id dari respons API yang gagal.