Claude di Google Cloud

API untuk mengakses Claude di Google Cloud's Agent Platform hampir identik dengan Messages API, dengan dua perbedaan utama dalam format permintaan:

• Di Agent Platform, model tidak diteruskan dalam body permintaan. Sebagai gantinya, model ditentukan dalam URL endpoint Google Cloud.
• Di Agent Platform, anthropic_version diteruskan dalam body permintaan (bukan sebagai header), dan harus diatur ke nilai vertex-2023-10-16.

Agent Platform juga didukung oleh SDK klien resmi Anthropic. Panduan ini memandu Anda dalam membuat permintaan ke Claude di Agent Platform menggunakan salah satu SDK klien Anthropic.

Perhatikan bahwa panduan ini mengasumsikan Anda sudah memiliki proyek Google Cloud yang dapat menggunakan Agent Platform. Lihat model Anthropic Claude di Agent Platform untuk informasi lebih lanjut tentang penyiapan yang diperlukan dan panduan lengkapnya.

Instal SDK untuk mengakses Agent Platform

Pertama, instal SDK klien Anthropic untuk bahasa pilihan Anda.

pip install -U "anthropic[vertex]"

Mengakses Agent Platform

Ketersediaan model

Perhatikan bahwa ketersediaan model Anthropic bervariasi menurut region. Cari "Claude" di Model Garden atau kunjungi model Anthropic Claude untuk informasi terbaru.

ID model API

Istilah siklus hidup (Deprecated, Retired) didefinisikan dalam 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 Agent Platform, lihat dokumentasi Google Cloud untuk model Claude di Agent Platform.

Membuat permintaan

Sebelum menjalankan permintaan, Anda mungkin perlu menjalankan gcloud auth application-default login untuk melakukan autentikasi dengan Google Cloud.

Contoh berikut menunjukkan cara menghasilkan teks dari Claude di Agent Platform:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Lihat SDK klien dan dokumentasi Agent Platform resmi untuk detail lebih lanjut.

Claude juga tersedia melalui Amazon Bedrock, Claude Platform on AWS, dan Microsoft Foundry.

Retensi data

Penanganan data untuk penawaran ini diatur oleh Google Cloud. Untuk detailnya, lihat Agent Platform dan zero data retention.

Pencatatan aktivitas

Agent Platform menyediakan layanan pencatatan permintaan-respons 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 beserta ketersediaannya di Google Cloud, lihat Ikhtisar fitur.

Sorotan fitur yang didukung

• Messages API
• Caching prompt
• Thinking
• Penggunaan alat, termasuk alat Bash, alat Browser use, alat Computer use, alat Memory, dan alat Text editor
• Alat pencarian web
• Kutipan
• Output terstruktur

Fitur yang tidak didukung

• Sumber input (sumber URL untuk gambar dan dokumen, Files API)
• Alat sisi server (eksekusi kode, web fetch, advisor)
• Infrastruktur agen (Agent Skills, konektor MCP, pemanggilan alat secara 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)

Jendela konteks

Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, dan Claude Sonnet 4.6 memiliki "context window" (jendela konteks) 1 juta token di Agent Platform. Model Claude lainnya, termasuk Sonnet 4.5 dan Sonnet 4 (deprecated), memiliki jendela konteks 200 ribu token.

Agent Platform membatasi payload permintaan hingga 30 MB. Saat mengirim dokumen besar atau banyak gambar, Anda mungkin mencapai batas ini sebelum batas token.

Endpoint global, multi-region, dan regional

Agent Platform menawarkan tiga jenis endpoint:

• Endpoint global: Perutean dinamis untuk ketersediaan maksimum
• Endpoint multi-region: Perutean dinamis dalam suatu wilayah geografis (misalnya, Amerika Serikat atau Uni Eropa) untuk residensi data dengan ketersediaan tinggi
• Endpoint regional: Perutean data yang terjamin melalui region geografis tertentu

Endpoint regional dan multi-region dikenakan premi harga 10% di atas 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 dengan residensi data yang fleksibel
• Hanya mendukung traffic pay-as-you-go (provisioned throughput memerlukan endpoint regional)

Endpoint multi-region:

• Merutekan permintaan secara dinamis ke berbagai region dalam suatu wilayah geografis (saat ini us dan eu)
• Berguna ketika Anda memerlukan residensi data dalam wilayah geografis yang luas tetapi menginginkan ketersediaan yang lebih tinggi daripada satu region
• Premi harga 10% di atas endpoint global
• Hanya mendukung traffic pay-as-you-go (provisioned throughput memerlukan endpoint regional)

Endpoint regional:

• Merutekan traffic melalui region geografis tertentu
• Diperlukan untuk residensi data satu region, mandat kepatuhan yang ketat, atau provisioned throughput
• Mendukung pay-as-you-go maupun provisioned throughput
• Premi harga 10% mencerminkan biaya infrastruktur untuk kapasitas regional khusus

Implementasi

Menggunakan endpoint global (direkomendasikan):

Atur parameter region ke "global" saat menginisialisasi klien:

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Menggunakan endpoint multi-region:

Atur parameter region ke pengenal multi-region: "us" untuk Amerika Serikat atau "eu" untuk Uni Eropa. SDK merutekan permintaan ke endpoint multi-region yang sesuai (https://aiplatform.us.rep.googleapis.com atau https://aiplatform.eu.rep.googleapis.com), yang secara dinamis menyeimbangkan traffic di berbagai region dalam wilayah geografis tersebut.

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us"  # Multi-region identifier: "us" or "eu"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Menggunakan endpoint regional:

Tentukan region spesifik seperti "us-east5" atau "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Endpoint regional tertentu mendukung Claude Sonnet 4.6 dan versi sebelumnya; model yang lebih baru menggunakan endpoint global atau multi-region
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Sumber daya tambahan

• Harga Agent Platform: Harga Generative AI di cloud.google.com
• Dokumentasi model Claude: Claude di Agent Platform
• Postingan blog Google: Endpoint global untuk model Claude
• Detail harga Anthropic: Harga platform cloud