Claude di Amazon Bedrock

Halaman ini mencakup integrasi Amazon Bedrock yang tersedia saat ini (API InvokeModel dan Converse dengan pengenal model berversi ARN dan pengkodean event-stream AWS). Pratinjau penelitian dari penawaran yang dikelola AWS baru, dengan Messages API di /anthropic/v1/messages dan streaming SSE, didokumentasikan di Claude di Amazon Bedrock (pratinjau penelitian).

Memanggil Claude melalui Bedrock sedikit berbeda dari cara Anda memanggil Claude saat menggunakan SDK klien Anthropic. 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 pemrograman.

Instal dan konfigurasikan AWS CLI

Instal versi AWS CLI pada versi 2.13.23 atau lebih baru
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.
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 SDK AWS 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 menurut wilayah. Lihat dokumentasi AWS untuk informasi terbaru.

ID model API

Claude Opus 4.7 tersedia di AWS melalui Claude di Amazon Bedrock, saat ini dalam pratinjau penelitian. Ini tidak tersedia melalui katalog model Bedrock standar yang didokumentasikan di halaman ini.

Model	ID model Bedrock dasar	`global`	`us`	`eu`	`jp`	`apac`
Claude Opus 4.6	anthropic.claude-opus-4-6-v1	Ya	Ya	Ya	Ya	Ya
Claude Sonnet 4.6	anthropic.claude-sonnet-4-6	Ya	Ya	Ya	Ya	Tidak
Claude Sonnet 4.5	anthropic.claude-sonnet-4-5-20250929-v1:0	Ya

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:

Membuat permintaan

Contoh berikut menunjukkan cara menghasilkan teks dari Claude di Bedrock:

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

Autentikasi token pembawa

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

Autentikasi token pembawa didukung dalam SDK C#, Go, dan Java. SDK PHP, Python, TypeScript, dan Ruby hanya menggunakan penandatanganan AWS SigV4.

Pendekatan paling sederhana adalah mengatur variabel lingkungan AWS_BEARER_TOKEN_BEDROCK, yang secara otomatis terdeteksi oleh resolusi kredensial fromEnv().

Untuk memberikan token secara terprogram:

Pencatatan aktivitas

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

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

Mengaktifkan layanan ini tidak memberikan AWS atau Anthropic akses apa pun ke konten Anda.

Dukungan fitur

Untuk semua fitur yang saat ini didukung di Bedrock, lihat ikhtisar fitur API.

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

Claude Opus 4.6 dan Claude Sonnet 4.6 memiliki jendela konteks 1M-token di Amazon Bedrock. Model Claude lainnya, termasuk Sonnet 4.5 dan Sonnet 4 (tidak direkomendasikan), memiliki jendela konteks 200k-token.

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

Global vs regional endpoints

Mulai dengan Claude Sonnet 4.5 dan semua model di masa depan, Amazon Bedrock menawarkan dua jenis endpoint:

Endpoint global: Perutean dinamis untuk ketersediaan maksimal
Endpoint regional: Perutean data yang dijamin melalui wilayah geografis tertentu

Endpoint regional mencakup premium harga 10% dibandingkan endpoint global.

Ini berlaku untuk Claude Sonnet 4.5 dan model di masa depan saja. Model yang lebih lama (Claude Sonnet 4 (tidak direkomendasikan), Opus 4 (tidak direkomendasikan), dan sebelumnya) mempertahankan struktur harga yang ada.

Kapan menggunakan setiap opsi

Endpoint global (direkomendasikan):

Memberikan ketersediaan dan uptime maksimal
Secara dinamis merutekan permintaan ke wilayah dengan kapasitas yang tersedia
Tidak ada premium 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, EU, Jepang, dan Australia
Premium harga 10% mencerminkan biaya infrastruktur untuk kapasitas regional khusus

Implementasi

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

ID model untuk Claude Sonnet 4.5 dan 4 (tidak direkomendasikan) sudah mencakup awalan global.:

Menggunakan endpoint regional (CRIS):

Untuk menggunakan endpoint regional, hapus awalan global. dari ID model:

Claude Mythos Preview adalah model pratinjau penelitian yang tersedia untuk pelanggan yang diundang di Amazon Bedrock. Untuk informasi lebih lanjut, lihat Project Glasswing.

Sumber daya tambahan

Harga AWS Bedrock: aws.amazon.com/bedrock/pricing
Dokumentasi harga AWS: Panduan harga Bedrock
Posting blog AWS: Memperkenalkan Claude Sonnet 4.5 di Amazon Bedrock
Detail harga Anthropic: Dokumentasi harga

import boto3

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

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

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-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)

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

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

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!" }],
});

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"}],
)

from anthropic import AnthropicBedrock

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

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