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 akun AWS dan mengonfigurasi akses programatik.

Instal dan konfigurasi AWS CLI

1. Instal versi AWS CLI versi 2.13.23 atau yang lebih baru.
2. Konfigurasikan kredensial AWS Anda menggunakan perintah AWS configure (lihat Konfigurasi AWS CLI) atau temukan kredensial Anda dengan menavigasi ke "Command line or programmatic access" di 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 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 region. Lihat dokumentasi AWS untuk informasi terbaru.

ID model API

Istilah siklus hidup (Deprecated, Retired) didefinisikan di Penghentian model. Tanggal siklus hidup di 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" (inferensi lintas region) alih-alih throughput on-demand. Untuk model-model ini, permintaan yang meneruskan ID model dasar akan gagal dengan error 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" (profil inferensi) alih-alih ID model dasar. ID profil inferensi adalah ID model dasar dengan awalan dari kolom bertanda "Yes" pada tabel berikut, misalnya us.anthropic.claude-sonnet-4-5-20250929-v1:0. Anda juga dapat meneruskan ARN profil inferensi lengkap, dalam bentuk arn:aws:bedrock:{region}:{account-id}:inference-profile/{inference-profile-id}. Untuk daftar resmi AWS tentang profil inferensi yang tersedia, lihat Region dan model yang didukung untuk profil inferensi. Untuk mempelajari bagaimana awalan 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:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autentikasi dengan menyediakan kunci di bawah ini 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 selengkapnya di https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region mengubah region aws tujuan permintaan. Jika tidak disediakan, SDK membaca
    # AWS_REGION / AWS_DEFAULT_REGION, lalu region yang dikonfigurasi untuk sesi boto3 atau profil AWS Anda
    # (termasuk ~/.aws/config), dan memunculkan ValueError jika tidak ada region yang dapat ditentukan.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

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

Autentikasi bearer token

Anda dapat melakukan autentikasi dengan Bedrock menggunakan "bearer token" (token pembawa) alih-alih kredensial AWS. Ini berguna di lingkungan perusahaan tempat tim memerlukan akses ke Bedrock tanpa mengelola kredensial AWS, peran IAM, atau izin tingkat akun.

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

Untuk menyediakan token secara terprogram:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    api_key="your-bearer-token",
    aws_region="us-west-2",
)

message = client.messages.create(
    model="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

Pencatatan aktivitas

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

Anthropic merekomendasikan agar Anda mencatat aktivitas Anda setidaknya dalam periode bergulir 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
• Kutipan
• Output terstruktur, untuk model-model dalam catatan Amazon Bedrock di bagian Kompatibilitas

Fitur yang tidak didukung

• Sumber input (sumber URL untuk gambar dan dokumen, Files API)
• Alat sisi server (eksekusi kode, pencarian web, web fetch, 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)
• Caching prompt otomatis (field cache_control tingkat atas; gunakan breakpoint cache eksplisit sebagai gantinya)
• Toolset computer use dan browser use (computer_toolset_20260801 dan browser_toolset_20260801 saat ini tidak tersedia di Amazon Bedrock; versi beta alat computer use tetap tersedia)

Dukungan PDF di Bedrock

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

Pertimbangan penting bagi pengguna Converse API:

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

Pesan sistem di tengah percakapan di Bedrock

Pesan sistem di tengah percakapan tersedia melalui InvokeModel API untuk Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Sonnet 5.5, dan Claude Haiku 5.5. Seperti dijelaskan dalam catatan di bagian ID model API, permintaan ini dilayani oleh infrastruktur yang sama dengan endpoint Claude di Amazon Bedrock. Tidak diperlukan header beta untuk pesan sistem di tengah percakapan. Fitur ini tidak tersedia di Claude Sonnet 5. Gunakan field system tingkat atas sebagai gantinya. Fitur ini tidak tersedia untuk model berversi ARN dalam tabel model di halaman ini.

Pesan role: "system" juga dapat mengatur output_config.effort untuk mengubah effort di tengah percakapan pada Claude Fable 5.1 dan Claude Opus 5.5. Fitur ini masih dalam beta: tambahkan mid-conversation-output-config-2026-07-01 ke array anthropic_beta di body permintaan. Tanpa nilai tersebut, atau pada Claude Fable 5, Claude Opus 5, atau Claude Opus 4.8, permintaan akan mengembalikan error 400: messages.N.output_config: Extra inputs are not permitted. Dalam error tersebut, N adalah indeks pesan system di dalam messages.

Untuk pengguna Converse API: Converse API menerima instruksi sistem melalui parameter system tingkat atasnya. Untuk menambahkan instruksi sistem di tengah percakapan, gunakan InvokeModel API.

Jendela konteks

Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, dan Claude Haiku 5.5 memiliki "context window" (jendela konteks) 1M token di Amazon Bedrock. Model Claude lainnya, termasuk Sonnet 4.5 (deprecated) 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

Mulai dari Claude Sonnet 4.5 dan semua model mendatang, Bedrock menawarkan dua jenis endpoint:

• Endpoint global: Perutean dinamis untuk ketersediaan maksimum
• Endpoint regional: Perutean data yang dijamin melalui region geografis tertentu

Endpoint regional dikenakan premi harga 10% dibandingkan endpoint global.

Kapan menggunakan setiap opsi

Endpoint global (direkomendasikan):

• Memberikan ketersediaan dan uptime maksimum
• Merutekan permintaan secara dinamis ke region dengan kapasitas yang tersedia
• Tanpa premi harga
• Terbaik untuk aplikasi di mana residensi data 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 (deprecated)):

ID model untuk Claude Opus 4.6, Sonnet 4.6, dan Sonnet 4.5 (deprecated) sudah menyertakan awalan global.:

from anthropic import AnthropicBedrock

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

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Menggunakan endpoint regional (CRIS):

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

from anthropic import AnthropicBedrock

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

# Menggunakan endpoint regional AS (CRIS)
message = client.messages.create(
    model="us.anthropic.claude-opus-4-6-v1",  # Regional prefix
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)

Sumber daya tambahan

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