Memanggil Claude melalui Bedrock sedikit berbeda dari cara Anda memanggil Claude saat menggunakan SDK klien Anthropic. Panduan ini akan memandu Anda melalui proses menyelesaikan panggilan API ke Claude di Bedrock dalam Python atau TypeScript. Perhatikan bahwa panduan ini mengasumsikan Anda telah mendaftar untuk akun AWS dan mengonfigurasi akses terprogram.

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 Konfigurasikan AWS CLI) atau temukan kredensial Anda dengan menavigasi ke “Command line or programmatic access” dalam dasbor AWS Anda dan mengikuti petunjuk dalam modal popup.
  3. Verifikasi bahwa kredensial Anda berfungsi:
Shell
aws sts get-caller-identity

Instal SDK untuk mengakses Bedrock

SDK klien Anthropic mendukung Bedrock. Anda juga dapat menggunakan AWS SDK 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

ModelID model Bedrock dasarglobaluseujpapac
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0Copied!YaYaYaYaTidak
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0Copied!YaYaYaTidakYa
Claude Sonnet 3.7 anthropic.claude-3-7-sonnet-20250219-v1:0Copied!TidakYaYaTidakYa
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0Copied!TidakYaTidakTidakTidak
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0Copied!TidakYaTidakTidakTidak
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0Copied!TidakYaTidakTidakTidak
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0Copied!YaYaYaTidakTidak
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0Copied!TidakYaTidakTidakTidak
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0Copied!TidakYaYaTidakYa
Untuk informasi lebih lanjut tentang ID model regional vs global, lihat bagian Global vs regional endpoints di bawah.

Daftar model yang tersedia

Contoh berikut menunjukkan cara mencetak daftar semua model Claude yang tersedia melalui Bedrock:
aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Membuat permintaan

Contoh berikut menunjukkan cara menghasilkan teks dari Claude di Bedrock:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentikasi dengan memberikan kunci di bawah atau gunakan penyedia kredensial AWS default, seperti
    # menggunakan ~/.aws/credentials atau variabel lingkungan "AWS_SECRET_ACCESS_KEY" dan "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Kredensial sementara dapat digunakan dengan aws_session_token.
    # Baca lebih lanjut di https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region mengubah wilayah aws tempat permintaan dibuat. Secara default, kami membaca AWS_REGION,
    # dan jika itu tidak ada, kami default ke us-east-1. Perhatikan bahwa kami tidak membaca ~/.aws/config untuk wilayah.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
print(message.content)
Lihat SDK klien kami untuk detail lebih lanjut, dan dokumentasi Bedrock resmi di sini.

Pencatatan aktivitas

Bedrock menyediakan layanan pencatatan invokasi yang memungkinkan pelanggan untuk mencatat prompt dan penyelesaian yang terkait dengan penggunaan Anda. Anthropic merekomendasikan bahwa Anda mencatat aktivitas Anda setidaknya pada dasar rolling 30 hari untuk memahami aktivitas Anda dan menyelidiki potensi penyalahgunaan.
Mengaktifkan layanan ini tidak memberikan AWS atau Anthropic akses apa pun ke konten Anda.

Dukungan fitur

Anda dapat menemukan semua fitur yang saat ini didukung di Bedrock di sini.

Dukungan PDF di Bedrock

Dukungan PDF tersedia di Amazon Bedrock melalui API Converse dan API InvokeModel. Untuk informasi terperinci tentang kemampuan dan batasan pemrosesan PDF, lihat dokumentasi dukungan PDF. Pertimbangan penting untuk pengguna API Converse:
  • Analisis PDF visual (bagan, gambar, tata letak) memerlukan kutipan untuk diaktifkan
  • Tanpa kutipan, hanya ekstraksi teks dasar yang tersedia
  • Untuk kontrol penuh tanpa kutipan paksa, gunakan API InvokeModel
Untuk detail lebih lanjut tentang dua mode pemrosesan dokumen dan batasan mereka, lihat panduan dukungan PDF.

Jendela konteks token 1M

Claude Sonnet 4 dan 4.5 mendukung jendela konteks token 1M di Amazon Bedrock.
Jendela konteks token 1M saat ini dalam beta. Untuk menggunakan jendela konteks yang diperluas, sertakan header beta context-1m-2025-08-07 dalam permintaan API Bedrock Anda.

Global vs regional endpoints

Mulai dengan Claude Sonnet 4.5 dan semua model di masa depan, Amazon Bedrock menawarkan dua jenis endpoint:
  • Global endpoints: Perutean dinamis untuk ketersediaan maksimal
  • Regional endpoints: Perutean data yang dijamin melalui wilayah geografis tertentu
Regional endpoints mencakup premi harga 10% dibandingkan dengan global endpoints.
Ini berlaku untuk Claude Sonnet 4.5 dan model di masa depan saja. Model yang lebih lama (Claude Sonnet 4, Opus 4, dan sebelumnya) mempertahankan struktur harga yang ada.

Kapan menggunakan setiap opsi

Global endpoints (direkomendasikan):
  • Memberikan ketersediaan dan uptime maksimal
  • Secara dinamis merutekan permintaan ke wilayah dengan kapasitas yang tersedia
  • Tidak ada premi harga
  • Terbaik untuk aplikasi di mana residensi data fleksibel
Regional endpoints (CRIS):
  • Merutekan lalu lintas melalui wilayah geografis tertentu
  • Diperlukan untuk persyaratan residensi data dan kepatuhan
  • Tersedia untuk AS, UE, Jepang, dan Australia
  • Premi harga 10% mencerminkan biaya infrastruktur untuk kapasitas regional khusus

Implementasi

Menggunakan global endpoints (default untuk Sonnet 4.5 dan 4): ID model untuk Claude Sonnet 4.5 dan 4 sudah mencakup awalan global.:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

message = client.messages.create(
    model="global.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)
Menggunakan regional endpoints (CRIS): Untuk menggunakan regional endpoints, hapus awalan global. dari ID model:
from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-west-2")

# Menggunakan endpoint regional AS (CRIS)
message = client.messages.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",  # Tanpa awalan global.
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Sumber daya tambahan