Amazon Bedrock API

Memanggil Claude melalui Bedrock sedikit berbeda dari cara Anda memanggil Claude ketika menggunakan SDK klien Anthropic. Panduan ini akan memandu Anda melalui proses menyelesaikan panggilan API ke Claude di Bedrock baik dalam Python atau TypeScript.

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 Konfigurasikan AWS CLI) atau temukan kredensial Anda dengan menavigasi ke “Command line or programmatic access” dalam dashboard AWS Anda dan mengikuti petunjuk dalam modal popup.
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

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

​

Nama model API

​

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

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

​

Pencatatan aktivitas

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

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

​

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 Converse API dan InvokeModel API. Untuk informasi detail tentang kemampuan dan keterbatasan pemrosesan PDF, lihat dokumentasi dukungan PDF.

Pertimbangan penting untuk pengguna Converse API:

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

Untuk detail lebih lanjut tentang dua mode pemrosesan dokumen dan keterbatasannya, rujuk ke panduan dukungan PDF.