Claude di Amazon Bedrock (Opus 4.6 dan sebelumnya)

Memanggil Claude melalui Bedrock sedikit berbeda dari cara Anda memanggil Claude di Claude API secara langsung. Panduan ini memandu Anda menyelesaikan panggilan API ke Claude di Bedrock menggunakan salah satu SDK klien Anthropic.

Perhatikan bahwa panduan ini mengasumsikan Anda telah mendaftar untuk akun AWS dan mengonfigurasi akses programatik.



Instal dan konfigurasikan AWS CLI

1. Instal versi AWS CLI pada atau lebih baru dari versi 2.13.23.
2. Konfigurasikan kredensial AWS Anda menggunakan perintah AWS configure (lihat Configure the AWS CLI) atau temukan kredensial Anda dengan menavigasi ke "Command line or programmatic access" di dalam dasbor AWS Anda dan mengikuti petunjuk di jendela modal.
3. Verifikasi bahwa kredensial Anda berfungsi:

aws sts get-caller-identity



Instal SDK untuk mengakses Bedrock

SDK klien Anthropic mendukung Bedrock. Anda juga dapat menggunakan SDK AWS seperti boto3 secara langsung.

pip install -U "anthropic[bedrock]"



Mengakses Bedrock



Berlangganan model Anthropic

Buka AWS Console > Bedrock > Model Access dan minta akses ke model Anthropic. Perhatikan bahwa ketersediaan model Anthropic bervariasi menurut wilayah. Lihat dokumentasi AWS untuk informasi terbaru.



ID model API

Istilah siklus hidup (Deprecated, Retired) didefinisikan di Penghentian model. Tanggal siklus hidup pada platform yang dioperasikan mitra ditetapkan oleh mitra dan dapat berbeda dari jadwal Claude API. Untuk tanggal penghentian terkini dari model apa pun di Amazon Bedrock, lihat halaman siklus hidup model Amazon Bedrock.

AWS menawarkan model Claude yang lebih baru melalui cross-region inference alih-alih throughput on-demand. Untuk model-model ini, permintaan yang meneruskan ID model dasar akan gagal dengan kesalahan HTTP 400 seperti berikut:

Invocation of model ID anthropic.claude-sonnet-4-5-20250929-v1:0 with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.

Untuk memanggil model-model ini, teruskan inference profile alih-alih ID model dasar. ID inference profile adalah ID model dasar dengan prefiks dari kolom yang ditandai "Ya" pada tabel berikut, misalnya us.anthropic.claude-sonnet-4-5-20250929-v1:0. Anda juga dapat meneruskan ARN inference profile lengkap, dalam bentuk arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}. Untuk daftar resmi AWS tentang inference profile yang tersedia, lihat Supported Regions and models for inference profiles. Untuk bagaimana prefiks memengaruhi perutean dan harga, lihat bagian Endpoint global versus regional.



Daftar model yang tersedia

Contoh berikut menunjukkan cara mencetak daftar semua model Claude yang tersedia melalui Bedrock:

import boto3

bedrock = boto3.client(service_name="bedrock")
response = bedrock.list_foundation_models(byProvider="anthropic")

for summary in response["modelSummaries"]:
    print(summary["modelId"])



Membuat permintaan

Contoh berikut menunjukkan cara menghasilkan teks dari Claude di Bedrock:

Lihat SDK klien untuk detail lebih lanjut, dan dokumentasi resmi Bedrock.



Autentikasi bearer token

Anda dapat melakukan autentikasi dengan Bedrock menggunakan bearer token alih-alih kredensial AWS. Ini berguna di lingkungan korporat di mana tim memerlukan akses ke Bedrock tanpa mengelola kredensial AWS, peran IAM, atau izin tingkat akun.

Pendekatan paling sederhana adalah menetapkan variabel lingkungan AWS_BEARER_TOKEN_BEDROCK, yang dideteksi secara otomatis oleh setiap SDK saat menyelesaikan kredensial dari lingkungan.

Untuk menyediakan token secara programatik:



Pencatatan aktivitas

Bedrock menyediakan layanan pencatatan invokasi yang memungkinkan Anda mencatat prompt dan completion yang terkait dengan penggunaan Anda.

Anthropic merekomendasikan agar Anda mencatat aktivitas Anda setidaknya secara bergulir selama 30 hari untuk memahami aktivitas Anda dan menyelidiki potensi penyalahgunaan.



Dukungan fitur

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



Sorotan fitur yang didukung

• Messages API
• Caching prompt
• Pemikiran
• Penggunaan alat, termasuk alat Bash, alat Computer use, alat Memory, dan alat Text editor
• Sitasi
• Output terstruktur



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 programatik)
• 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)



Dukungan PDF di Bedrock

Dukungan PDF tersedia di Bedrock melalui Converse API dan InvokeModel API. Untuk informasi terperinci tentang kemampuan dan keterbatasan pemrosesan PDF, lihat Dukungan PDF Amazon Bedrock.

Pertimbangan penting untuk pengguna Converse API:

• Analisis PDF visual (bagan, gambar, tata letak) memerlukan sitasi untuk diaktifkan
• Tanpa sitasi, hanya ekstraksi teks dasar yang tersedia
• Untuk kontrol penuh tanpa sitasi yang dipaksakan, gunakan InvokeModel API



Jendela konteks

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, dan Claude Sonnet 4.6 memiliki jendela konteks 1M token di Amazon Bedrock. Model Claude lainnya, termasuk Sonnet 4.5 dan Sonnet 4 (deprecated), memiliki jendela konteks 200k token.

Bedrock membatasi payload permintaan hingga 20 MB. Saat mengirim dokumen besar atau banyak gambar, Anda mungkin mencapai batas ini sebelum batas token.



Endpoint global versus regional

Dimulai dengan Claude Sonnet 4.5 dan semua model mendatang, Bedrock menawarkan dua jenis endpoint:

• Endpoint global: Perutean dinamis untuk ketersediaan maksimum
• Endpoint regional: Perutean data terjamin melalui wilayah geografis tertentu

Endpoint regional menyertakan premi harga 10% dibandingkan endpoint global.



Kapan menggunakan setiap opsi

Endpoint global (direkomendasikan):

• Memberikan ketersediaan dan waktu aktif maksimum
• Merutekan permintaan secara dinamis ke wilayah dengan kapasitas yang tersedia
• Tanpa premi harga
• Terbaik untuk aplikasi di mana residensi data bersifat fleksibel

Endpoint regional (CRIS):

• Merutekan lalu lintas melalui wilayah geografis tertentu
• Diperlukan untuk persyaratan residensi data dan kepatuhan
• Tersedia untuk AS, UE, Jepang, dan Asia-Pasifik
• Premi harga 10% mencerminkan biaya infrastruktur untuk kapasitas regional khusus



Implementasi

Menggunakan endpoint global (default untuk Opus 4.6, Sonnet 4.6, dan Sonnet 4.5):

ID model untuk Claude Opus 4.6, Sonnet 4.6, dan Sonnet 4.5 sudah menyertakan prefiks global.:

Menggunakan endpoint regional (CRIS):

Untuk menggunakan endpoint regional, ganti prefiks global. dengan prefiks regional seperti us.:



Sumber daya tambahan

• Harga Bedrock: Halaman harga Amazon Bedrock
• Dokumentasi harga AWS: Panduan harga Bedrock
• Postingan blog AWS: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Detail harga Anthropic: Harga platform cloud