Documentation

Claude di Amazon Bedrock

Akses model Claude melalui Amazon Bedrock dengan autentikasi asli AWS, penagihan, dan batas keamanan.

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 tanpa akses operator (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 penawaran Claude di Amazon Bedrock yang baru, yang mengekspos Messages API di /anthropic/v1/messages. Untuk integrasi Bedrock warisan (API InvokeModel dengan pengenal model versi ARN dan pengkodean aliran peristiwa AWS), lihat Claude di Amazon Bedrock.

Pratinjau penelitian

Claude di Amazon Bedrock berada dalam pratinjau penelitian, tersedia di wilayah US East (N. Virginia) us-east-1 saat peluncuran. Hubungi eksekutif akun Anthropic Anda untuk meminta akses.

Prasyarat

Sebelum Anda memulai, pastikan Anda memiliki:

Akun AWS baru di 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).
AWS CLI diinstal dan dikonfigurasi (opsional, untuk manajemen kredensial)
Setelah daftar putih, AWS mengirimkan email sambutan dengan ID model Anda dan detail pengaturan tambahan.

Autentikasi

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

Peran layanan Bedrock (direkomendasikan)

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.
Developer: lewatkan peran
Saat memanggil API, lewatkan ARN peran layanan sebagai parameter permintaan. Bedrock mengasumsikan peran atas nama Anda dan menandatangani permintaan dengan kredensial yang dikelola AWS. Contoh kode yang menunjukkan di mana parameter ARN berada akan ditambahkan ketika paket SDK dipublikasikan.

Peran yang diasumsikan IAM

Untuk akses yang difederasikan identitas dengan sesi maksimal 12 jam:

Admin: konfigurasi 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.
Developer: 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.

Token pembawa

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.
Developer: cetak token
Gunakan CLI aws-bedrock-token-generator (tautan tertunda publikasi) untuk mencetak token pembawa. Lewatkan di header x-api-key pada setiap permintaan.

Instal SDK

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

Membuat permintaan pertama Anda

Titik akhir mengikuti pola https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. Tidak seperti integrasi Bedrock warisan, titik akhir ini menggunakan streaming SSE standar dan bentuk badan permintaan yang sama dengan API pihak pertama Anthropic.

SDK menyelesaikan kredensial dan wilayah menggunakan urutan prioritas 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).

Jika klien khusus AnthropicBedrockMantle belum tersedia di rilis SDK bahasa Anda, Anda dapat menggunakan klien Anthropic standar sebagai gantinya: atur base_url ke https://bedrock-mantle.{region}.api.aws/anthropic dan lewatkan token pembawa Anda sebagai api_key. Jalur ini hanya mendukung autentikasi token pembawa. Penandatanganan SigV4 memerlukan klien khusus.

Model yang didukung

ID model di Claude di Amazon Bedrock membawa awalan penyedia anthropic.. Kemampuan dan perilaku model didokumentasikan di halaman Ikhtisar Model. Lihat email sambutan AWS Anda untuk ID model yang tepat yang diaktifkan untuk akun Anda.

Ketersediaan fitur

Claude di Amazon Bedrock mendukung fitur yang berjalan di dalam model. Fitur yang memerlukan infrastruktur yang dioperasikan Anthropic tidak tersedia.

Didukung:

Messages API (/v1/messages)
Prompt caching
Extended thinking
Tool use (alat yang ditentukan klien)
Citations
Structured outputs
In-region inference (permintaan tetap di satu wilayah AWS)

Tidak didukung:

Alat yang ditentukan Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
Agent API
Message Batches API
Titik akhir /v1/users

Wilayah

Pratinjau penelitian tersedia di us-east-1 (IAD) saja.

Kuota

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

Retensi data

Semua data inferensi disimpan selama 30 hari di penyimpanan AWS Anda. Tidak ada opsi retensi data nol pada penawaran ini. Untuk pelanggan standar, Anthropic dapat memeriksa data yang disimpan untuk tinjauan keselamatan dan penyalahgunaan. Untuk pelanggan tingkat Select, hanya AWS yang dapat memeriksa data; Anthropic dapat menjalankan operasi otomatis tetapi tidak tinjauan manual. Untuk detail tentang kelayakan tingkat Select, hubungi eksekutif akun Anthropic Anda.

Observabilitas

Claude di Amazon Bedrock mengirimkan log ke CloudWatch dan CloudTrail. Anthropic merekomendasikan mempertahankan log aktivitas setidaknya pada basis rolling 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah.

Dukungan

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

Was this page helpful?

Documentation

Claude di Amazon Bedrock

Akses model Claude melalui Amazon Bedrock dengan autentikasi asli AWS, penagihan, dan batas keamanan.

Pratinjau penelitian

Claude di Amazon Bedrock berada dalam pratinjau penelitian, tersedia di wilayah US East (N. Virginia) us-east-1 saat peluncuran. Hubungi eksekutif akun Anthropic Anda untuk meminta akses.

Prasyarat

Sebelum Anda memulai, pastikan Anda memiliki:

Akun AWS baru di 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).
AWS CLI diinstal dan dikonfigurasi (opsional, untuk manajemen kredensial)
Setelah daftar putih, AWS mengirimkan email sambutan dengan ID model Anda dan detail pengaturan tambahan.

Autentikasi

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

Peran layanan Bedrock (direkomendasikan)

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.
Developer: lewatkan peran
Saat memanggil API, lewatkan ARN peran layanan sebagai parameter permintaan. Bedrock mengasumsikan peran atas nama Anda dan menandatangani permintaan dengan kredensial yang dikelola AWS. Contoh kode yang menunjukkan di mana parameter ARN berada akan ditambahkan ketika paket SDK dipublikasikan.

Peran yang diasumsikan IAM

Untuk akses yang difederasikan identitas dengan sesi maksimal 12 jam:

Admin: konfigurasi 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.
Developer: 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.

Token pembawa

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.
Developer: cetak token
Gunakan CLI aws-bedrock-token-generator (tautan tertunda publikasi) untuk mencetak token pembawa. Lewatkan di header x-api-key pada setiap permintaan.

Instal SDK

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

Membuat permintaan pertama Anda

Model yang didukung

Ketersediaan fitur

Claude di Amazon Bedrock mendukung fitur yang berjalan di dalam model. Fitur yang memerlukan infrastruktur yang dioperasikan Anthropic tidak tersedia.

Didukung:

Messages API (/v1/messages)
Prompt caching
Extended thinking
Tool use (alat yang ditentukan klien)
Citations
Structured outputs
In-region inference (permintaan tetap di satu wilayah AWS)

Tidak didukung:

Alat yang ditentukan Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
Agent API
Message Batches API
Titik akhir /v1/users

Wilayah

Pratinjau penelitian tersedia di us-east-1 (IAD) saja.

Kuota

Retensi data

Observabilitas

Dukungan

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

Was this page helpful?

from anthropic import AnthropicBedrockMantle

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

message = client.messages.create(
    model="CLAUDE_MODEL_ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(message.content[0].text)