Claude di Amazon Bedrock (legacy)

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 client SDK Anthropic.

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

Instal dan konfigurasi 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 dashboard AWS Anda dan mengikuti petunjuk di modal popup.
3. Verifikasi bahwa kredensial Anda berfungsi:

aws sts get-caller-identity

Instal SDK untuk mengakses Bedrock

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

Mengakses Bedrock

Berlangganan model Anthropic

Buka AWS Console > Bedrock > Model Access dan minta akses ke model Anthropic. Perhatikan bahwa ketersediaan model Anthropic bervariasi berdasarkan region. 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.

Untuk informasi lebih lanjut tentang ID model regional vs global, lihat bagian Endpoint global vs 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. Secara default, SDK membaca AWS_REGION,
    # dan jika tidak ada, default-nya adalah us-east-1. Perhatikan bahwa SDK tidak membaca ~/.aws/config untuk region.
    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 client SDK 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, IAM role, atau izin tingkat akun.

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

Untuk menyediakan token secara terprogram:

using Anthropic.Bedrock;
using Anthropic.Models.Messages;

var client = new AnthropicBedrockClient(
    new AnthropicBedrockApiTokenCredentials
    {
        BearerToken = "your-bearer-token",
        Region = "us-west-2",
    }
);

var response = await client.Messages.Create(new MessageCreateParams
{
    Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
    MaxTokens = 1024,
    Messages = [new() { Role = Role.User, Content = "Hello!" }],
});

Pencatatan aktivitas

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

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

Dukungan fitur

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

Sorotan fitur yang didukung

• Messages API
• Caching prompt
• Pemikiran diperpanjang
• Penggunaan alat, 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 (code execution, web search, web fetch, advisor)
• Infrastruktur agen (Agent Skills, MCP connector, programmatic tool calling)
• 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 batasan pemrosesan PDF, lihat Dukungan PDF Amazon Bedrock.

Pertimbangan penting untuk pengguna Converse API:

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

Jendela konteks

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, dan Claude Sonnet 4.6 memiliki jendela konteks 1 juta token di Amazon Bedrock. Model Claude lainnya, termasuk Sonnet 4.5 dan Sonnet 4 (deprecated), memiliki jendela konteks 200 ribu 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 vs regional

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

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

Endpoint regional menyertakan premium harga 10% dibandingkan endpoint global.

Kapan menggunakan setiap opsi

Endpoint global (direkomendasikan):

• Menyediakan ketersediaan dan uptime maksimum
• Secara dinamis merutekan permintaan ke region dengan kapasitas yang tersedia
• Tidak ada premium harga
• Terbaik untuk aplikasi di mana residensi data bersifat fleksibel

Endpoint regional (CRIS):

• Merutekan lalu lintas melalui region geografis tertentu
• Diperlukan untuk persyaratan residensi data dan kepatuhan
• Tersedia untuk AS, UE, Jepang, dan Asia-Pasifik
• Premium 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.:

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 prefiks global. dengan prefiks 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: aws.amazon.com/bedrock/pricing
• Dokumentasi harga AWS: Panduan harga Bedrock
• Postingan blog AWS: Introducing Claude Sonnet 4.5 in Amazon Bedrock
• Detail harga Anthropic: Harga platform cloud