Panduan ini memandu Anda melalui pengaturan dan pembuatan 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 yang Anda gunakan dengan API pihak pertama Anthropic.
Halaman ini mencakup pratinjau penelitian dari penawaran Claude di Amazon Bedrock yang baru, yang mengekspos Messages API di /anthropic/v1/messages. Untuk integrasi Bedrock yang ada (API InvokeModel dan Converse dengan pengenal model yang diversi ARN dan pengkodean event-stream AWS), lihat Claude di Amazon Bedrock.
Titik akhir Claude di Amazon Bedrock berada dalam pratinjau penelitian, tersedia di wilayah US East (N. Virginia) us-east-1. Hubungi eksekutif akun Anthropic Anda untuk meminta akses.
Sebelum Anda memulai, pastikan Anda memiliki:
us-east-1. Pratinjau penelitian memerlukan akun khusus untuk isolasi. Eksekutif akun Anthropic Anda akan mengirimkan ID akun Anda ke tim Bedrock Marketplace untuk daftar putih (biasanya diproses dalam 24 jam).Was this page helpful?
Claude di Amazon Bedrock mendukung tiga jalur autentikasi. Pilih yang paling sesuai dengan persyaratan keamanan Anda.
Gunakan peran layanan Bedrock dengan kunci yang dikelola AWS untuk akses jangka panjang yang paling aman:
Admin: menyediakan peran layanan
Administrator AWS menyediakan peran layanan Bedrock dan memberikan izin iam:PassRole kepada pengembang pada ARN peran layanan.
Pengembang: meneruskan peran
Saat memanggil API, Bedrock mengasumsikan peran layanan atas nama Anda. Lihat dokumentasi Amazon Bedrock untuk cara mengasosiasikan peran dengan permintaan Anda.
Untuk akses yang difederasikan identitas dengan sesi maksimal 12 jam:
Admin: mengonfigurasi peran IAM
Buat peran IAM yang dibatasi pada model Claude Anda. Kebijakan kepercayaan menamai penyedia identitas Anda (SAML, OIDC, atau AWS Identity Center). Kebijakan izin memberikan bedrock-mantle:CreateInference hanya pada ARN model yang diizinkan.
Pengembang: autentikasi dan asumsikan
Autentikasi melalui penyedia identitas perusahaan Anda, kemudian asumsikan peran IAM. AWS STS mengeluarkan kredensial sementara yang digunakan SDK atau CLI untuk menandatangani permintaan.
Untuk akses jangka pendek tanpa peran IAM (maksimal 12 jam, paling tidak disukai):
Admin: batasi jenis token
Blokir kunci jangka panjang dengan melampirkan kebijakan yang menolak bedrock:CallWithBearerToken kecuali kondisi bedrock:BearerTokenType cocok dengan token jangka pendek.
Pengembang: buat token
Gunakan CLI aws-bedrock-token-generator untuk membuat token pembawa. Teruskan dalam header x-api-key pada setiap permintaan.
SDK klien Anthropic mendukung Claude di Amazon Bedrock melalui paket atau modul khusus Bedrock.
Titik akhir mengikuti pola https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Tidak seperti integrasi berbasis InvokeModel, titik akhir ini menggunakan streaming SSE standar dan bentuk badan permintaan yang sama dengan API pihak pertama Anthropic.
SDK menyelesaikan kredensial dan wilayah menggunakan preseden AWS standar: argumen konstruktor, kemudian variabel lingkungan (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), kemudian file konfigurasi AWS dan rantai kredensial (SSO, peran yang diasumsikan, peran tugas ECS, IMDS).
Anda juga dapat menggunakan klien Anthropic standar: atur base_url ke https://bedrock-mantle.{region}.api.aws/anthropic dan teruskan token pembawa Anda sebagai api_key. Jalur ini hanya mendukung autentikasi token pembawa. Penandatanganan SigV4 memerlukan klien khusus.
ID model di Claude di Amazon Bedrock membawa awalan penyedia anthropic.. Kemampuan dan perilaku model didokumentasikan di halaman Ikhtisar Model.
| Model | ID Model |
|---|---|
| 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 di Amazon Bedrock mendukung fitur yang berjalan di dalam model. Fitur yang memerlukan infrastruktur yang dioperasikan Anthropic tidak tersedia.
Didukung:
/v1/messages)Tidak didukung:
/v1/usersPratinjau penelitian tersedia di us-east-1 (IAD) saja.
Kuota default adalah 2 juta token input per menit (TPM). Anda dapat meminta hingga 4 juta input TPM tanpa persetujuan Anthropic tambahan. AWS memberlakukan batas permintaan per menit (RPM) di sisi Bedrock; hubungi dukungan AWS untuk penyesuaian RPM.
Penanganan data untuk penawaran ini diatur oleh Amazon Bedrock. Untuk detail, lihat Data protection in Amazon Bedrock.
Retensi data nol (ZDR) tersedia. Untuk mengaktifkan ZDR untuk akun Anda, hubungi dukungan AWS.
Claude di Amazon Bedrock mengirimkan log ke CloudWatch dan CloudTrail. Anthropic merekomendasikan mempertahankan log aktivitas setidaknya pada dasar rolling 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah.
Untuk dukungan pratinjau penelitian, hubungi [email protected]. Sertakan ID akun AWS Anda dan request-id dari respons API apa pun yang gagal.
Claude Mythos Preview adalah model pratinjau penelitian yang tersedia untuk pelanggan yang diundang di Amazon Bedrock. Untuk informasi lebih lanjut, lihat Project Glasswing.