MessagesClaude di platform cloud

Claude di Amazon Bedrock

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

Panduan ini memandu Anda melalui penyiapan dan pembuatan panggilan API ke Claude di Amazon Bedrock. Claude di Amazon Bedrock berjalan pada infrastruktur yang dikelola AWS dengan zero operator access (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.

Halaman ini membahas Claude di Amazon Bedrock, yang menyajikan Claude melalui Messages API di /anthropic/v1/messages pada infrastruktur yang dikelola AWS. Integrasi Amazon Bedrock sebelumnya (API InvokeModel dan Converse dengan pengidentifikasi model berversi ARN) tetap tersedia dan didokumentasikan di Claude di Amazon Bedrock (legacy). Untuk alternatif yang dioperasikan Anthropic di AWS dengan penagihan AWS Marketplace dan akses fitur yang biasanya tersedia di hari yang sama, lihat Claude Platform di AWS.

Akses

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. Claude Mythos Preview memerlukan undangan; lihat 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 mengirimkan ID akun Anda untuk dimasukkan ke allowlist (biasanya diproses dalam 24 jam), dan AWS akan mengirimkan email sambutan setelah selesai.

Autentikasi

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

Bedrock service role (direkomendasikan)

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

Admin: sediakan service role
Administrator AWS menyediakan Bedrock service role dan memberikan izin iam:PassRole kepada developer pada ARN service role tersebut.
Developer: teruskan role
Saat memanggil API, Bedrock mengambil alih service role atas nama Anda. Lihat dokumentasi Amazon Bedrock untuk cara mengaitkan role dengan permintaan Anda.

IAM assumed roles

Untuk akses dengan federasi identitas dengan sesi maksimum 12 jam:

Admin: konfigurasikan IAM role
Buat IAM role yang dibatasi 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.
Developer: autentikasi dan assume
Lakukan autentikasi melalui penyedia identitas korporat 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):

Admin: batasi jenis token
Blokir kunci jangka panjang dengan melampirkan policy yang menolak bedrock:CallWithBearerToken kecuali kondisi bedrock:BearerTokenType cocok dengan token jangka pendek.
Developer: buat token
Gunakan CLI aws-bedrock-token-generator untuk membuat bearer token. Teruskan token tersebut di header x-api-key pada setiap permintaan.

Instal 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. 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 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 roles, ECS task role, IMDS).

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

Anda juga dapat menggunakan klien Anthropic standar: atur base_url ke https://bedrock-mantle.{region}.api.aws/anthropic dan teruskan bearer token Anda sebagai api_key. Jalur ini hanya mendukung autentikasi bearer-token. Penandatanganan SigV4 memerlukan klien khusus.

Model yang didukung

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

Model	ID Model	Akses
Claude Fable 5	anthropic.claude-fable-5	Terbuka
Claude Opus 4.8	anthropic.claude-opus-4-8	Terbuka
Claude Opus 4.7	anthropic.claude-opus-4-7	Terbuka
Claude Sonnet 5	`anthropic.claude-sonnet-5`	Terbuka
Claude Haiku 4.5	anthropic.claude-haiku-4-5	Terbuka
Claude Mythos Preview	anthropic.claude-mythos-preview	Hanya dengan undangan (Project Glasswing)

Melakukan upgrade ke model Claude yang lebih baru? Di Claude Code, jalankan /claude-api migrate untuk menerapkan penggantian ID model dan perubahan parameter yang bersifat breaking di seluruh codebase Anda. Skill ini mendeteksi platform cloud mana yang ditargetkan oleh kode Anda dan menyesuaikan format ID model serta perubahan fitur untuk platform tersebut. Lihat Migrasi ke model Claude yang lebih baru.

Dukungan fitur

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

Sorotan fitur yang didukung

Messages API (/anthropic/v1/messages)
Prompt caching
Extended thinking
Tool use, termasuk Bash tool, Computer use tool, Memory tool, dan Text editor tool
Citations
Structured outputs

Fitur yang tidak didukung

Sumber input (sumber URL untuk gambar dan dokumen, Files API)
Alat sisi server (eksekusi kode, pencarian web, pengambilan web, 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)

Region

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

Global: perutean dinamis di semua region yang tersedia untuk ketersediaan maksimum. Tanpa premi harga.
Regional: endpoint diarahkan ke satu region AWS yang Anda tentukan, untuk kebutuhan residensi data. Endpoint regional dikenakan premi harga 10% dibandingkan endpoint global. Untuk merutekan ke beberapa region dalam satu geografi, gunakan inference profile (US, EU, JP, atau AU). Region yang ditandai Hanya dalam region pada tabel mendukung perutean satu region langsung tanpa inference profile.

Endpoint global tersedia untuk Claude Fable 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.

Region AWS	Lokasi	Jenis endpoint
`af-south-1`	Afrika (Cape Town)	Global
`ap-northeast-1`	Asia Pasifik (Tokyo)	Global, JP, Hanya dalam region
`ap-northeast-2`	Asia Pasifik (Seoul)	Global
`ap-northeast-3`	Asia Pasifik (Osaka)	Global, JP
`ap-south-1`	Asia Pasifik (Mumbai)	Global
`ap-south-2`	Asia Pasifik (Hyderabad)	Global
`ap-southeast-1`	Asia Pasifik (Singapura)	Global
`ap-southeast-2`	Asia Pasifik (Sydney)	Global, AU
`ap-southeast-3`	Asia Pasifik (Jakarta)	Global
`ap-southeast-4`	Asia Pasifik (Melbourne)	Global, AU, Hanya dalam region
`ca-central-1`	Kanada (Tengah)	Global, US
`ca-west-1`	Kanada Barat (Calgary)	Global
`eu-central-1`	Eropa (Frankfurt)	Global, EU
`eu-central-2`	Eropa (Zurich)	Global, EU
`eu-north-1`	Eropa (Stockholm)	Global, EU, Hanya dalam region
`eu-south-1`	Eropa (Milan)	Global, EU
`eu-south-2`	Eropa (Spanyol)	Global, EU
`eu-west-1`	Eropa (Irlandia)	Global, EU, Hanya dalam region
`eu-west-2`	Eropa (London)	Global, EU
`eu-west-3`	Eropa (Paris)	Global, EU
`il-central-1`	Israel (Tel Aviv)	Global
`me-central-1`	Timur Tengah (UEA)	Global
`sa-east-1`	Amerika Selatan (São Paulo)	Global
`us-east-1`	AS Timur (Virginia Utara)	Global, US, Hanya dalam region
`us-east-2`	AS Timur (Ohio)	Global, US, Hanya dalam region
`us-west-1`	AS Barat (California Utara)	Global, US
`us-west-2`	AS Barat (Oregon)	Global, US, Hanya dalam region

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 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 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.

Claude Mythos Preview adalah model research preview yang tersedia bagi pelanggan yang diundang di Amazon Bedrock. Untuk informasi lebih lanjut, lihat Project Glasswing.

Was this page helpful?

MessagesClaude di platform cloud

Claude di Amazon Bedrock

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

Akses

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).

Autentikasi

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

Bedrock service role (direkomendasikan)

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

Admin: sediakan service role
Administrator AWS menyediakan Bedrock service role dan memberikan izin iam:PassRole kepada developer pada ARN service role tersebut.
Developer: teruskan role
Saat memanggil API, Bedrock mengambil alih service role atas nama Anda. Lihat dokumentasi Amazon Bedrock untuk cara mengaitkan role dengan permintaan Anda.

IAM assumed roles

Untuk akses dengan federasi identitas dengan sesi maksimum 12 jam:

Admin: konfigurasikan IAM role
Buat IAM role yang dibatasi 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.
Developer: autentikasi dan assume
Lakukan autentikasi melalui penyedia identitas korporat 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):

Admin: batasi jenis token
Blokir kunci jangka panjang dengan melampirkan policy yang menolak bedrock:CallWithBearerToken kecuali kondisi bedrock:BearerTokenType cocok dengan token jangka pendek.
Developer: buat token
Gunakan CLI aws-bedrock-token-generator untuk membuat bearer token. Teruskan token tersebut di header x-api-key pada setiap permintaan.

Instal SDK

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

pip install -U "anthropic[bedrock]"

Membuat permintaan pertama Anda

curl https://bedrock-mantle.us-east-1.api.aws/anthropic/v1/messages \
  --aws-sigv4 "aws:amz:us-east-1:bedrock-mantle" \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic.claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

Model yang didukung

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

Model	ID Model	Akses
Claude Fable 5	anthropic.claude-fable-5	Terbuka
Claude Opus 4.8	anthropic.claude-opus-4-8	Terbuka
Claude Opus 4.7	anthropic.claude-opus-4-7	Terbuka
Claude Sonnet 5	`anthropic.claude-sonnet-5`	Terbuka
Claude Haiku 4.5	anthropic.claude-haiku-4-5	Terbuka
Claude Mythos Preview	anthropic.claude-mythos-preview	Hanya dengan undangan (Project Glasswing)

Dukungan fitur

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

Sorotan fitur yang didukung

Messages API (/anthropic/v1/messages)
Prompt caching
Extended thinking
Tool use, termasuk Bash tool, Computer use tool, Memory tool, dan Text editor tool
Citations
Structured outputs

Fitur yang tidak didukung

Sumber input (sumber URL untuk gambar dan dokumen, Files API)
Alat sisi server (eksekusi kode, pencarian web, pengambilan web, 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)

Region

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

Global: perutean dinamis di semua region yang tersedia untuk ketersediaan maksimum. Tanpa premi harga.
Regional: endpoint diarahkan ke satu region AWS yang Anda tentukan, untuk kebutuhan residensi data. Endpoint regional dikenakan premi harga 10% dibandingkan endpoint global. Untuk merutekan ke beberapa region dalam satu geografi, gunakan inference profile (US, EU, JP, atau AU). Region yang ditandai Hanya dalam region pada tabel mendukung perutean satu region langsung tanpa inference profile.

Endpoint global tersedia untuk Claude Fable 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.

Region AWS	Lokasi	Jenis endpoint
`af-south-1`	Afrika (Cape Town)	Global
`ap-northeast-1`	Asia Pasifik (Tokyo)	Global, JP, Hanya dalam region
`ap-northeast-2`	Asia Pasifik (Seoul)	Global
`ap-northeast-3`	Asia Pasifik (Osaka)	Global, JP
`ap-south-1`	Asia Pasifik (Mumbai)	Global
`ap-south-2`	Asia Pasifik (Hyderabad)	Global
`ap-southeast-1`	Asia Pasifik (Singapura)	Global
`ap-southeast-2`	Asia Pasifik (Sydney)	Global, AU
`ap-southeast-3`	Asia Pasifik (Jakarta)	Global
`ap-southeast-4`	Asia Pasifik (Melbourne)	Global, AU, Hanya dalam region
`ca-central-1`	Kanada (Tengah)	Global, US
`ca-west-1`	Kanada Barat (Calgary)	Global
`eu-central-1`	Eropa (Frankfurt)	Global, EU
`eu-central-2`	Eropa (Zurich)	Global, EU
`eu-north-1`	Eropa (Stockholm)	Global, EU, Hanya dalam region
`eu-south-1`	Eropa (Milan)	Global, EU
`eu-south-2`	Eropa (Spanyol)	Global, EU
`eu-west-1`	Eropa (Irlandia)	Global, EU, Hanya dalam region
`eu-west-2`	Eropa (London)	Global, EU
`eu-west-3`	Eropa (Paris)	Global, EU
`il-central-1`	Israel (Tel Aviv)	Global
`me-central-1`	Timur Tengah (UEA)	Global
`sa-east-1`	Amerika Selatan (São Paulo)	Global
`us-east-1`	AS Timur (Virginia Utara)	Global, US, Hanya dalam region
`us-east-2`	AS Timur (Ohio)	Global, US, Hanya dalam region
`us-west-1`	AS Barat (California Utara)	Global, US
`us-west-2`	AS Barat (Oregon)	Global, US, Hanya dalam region

Kuota

Retensi data

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

Pemantauan dan logging

Dukungan

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

Claude Mythos Preview adalah model research preview yang tersedia bagi pelanggan yang diundang di Amazon Bedrock. Untuk informasi lebih lanjut, lihat Project Glasswing.

Was this page helpful?

Akses

Prasyarat

Autentikasi

Bedrock service role (direkomendasikan)

IAM assumed roles

Bearer token

Instal SDK

Membuat permintaan pertama Anda

Model yang didukung

Dukungan fitur

Sorotan fitur yang didukung

Fitur yang tidak didukung

Region

Kuota

Retensi data

Pemantauan dan logging

Dukungan

Akses

Prasyarat

Autentikasi

Bedrock service role (direkomendasikan)

IAM assumed roles

Bearer token

Instal SDK

Membuat permintaan pertama Anda

Model yang didukung

Dukungan fitur

Sorotan fitur yang didukung

Fitur yang tidak didukung

Region

Kuota

Retensi data

Pemantauan dan logging

Dukungan

Akses

Prasyarat

Autentikasi

Bedrock service role (direkomendasikan)

IAM assumed roles

Bearer token

Instal SDK

Membuat permintaan pertama Anda

Model yang didukung

Dukungan fitur

Sorotan fitur yang didukung

Fitur yang tidak didukung

Region

Kuota

Retensi data

Pemantauan dan logging

Dukungan

Akses

Prasyarat

Autentikasi

Bedrock service role (direkomendasikan)

IAM assumed roles

Bearer token

Instal SDK

Membuat permintaan pertama Anda

Model yang didukung

Dukungan fitur

Sorotan fitur yang didukung

Fitur yang tidak didukung

Region

Kuota

Retensi data

Pemantauan dan logging

Dukungan