Claude di Google Cloud

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

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

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

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



Menginstal SDK untuk mengakses Agent Platform

Pertama, instal client SDK Anthropic untuk bahasa pemrograman pilihan Anda.

pip install -U "anthropic[vertex]"



Mengakses Agent Platform



Ketersediaan model

Perhatikan bahwa ketersediaan model Anthropic bervariasi berdasarkan region. Cari "Claude" di Model Garden atau kunjungi Model Claude Anthropic 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 tersebut 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 client SDK dan dokumentasi resmi Agent Platform untuk detail lebih lanjut.

Claude juga tersedia melalui Amazon Bedrock, Claude Platform di 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 secara bergulir selama 30 hari untuk memahami aktivitas Anda dan menyelidiki potensi penyalahgunaan.



Dukungan fitur

Untuk daftar fitur lengkap beserta ketersediaannya di Google Cloud, lihat Ringkasan fitur.



Sorotan fitur yang didukung

• Messages API
• Caching prompt
• Thinking
• Penggunaan alat, termasuk Bash tool, Computer use tool, Memory tool, dan Text editor tool
• Web search tool
• Citations
• Structured outputs



Fitur yang tidak didukung

• Sumber input (sumber URL untuk gambar dan dokumen, Files API)
• Alat sisi server (code execution, 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)



Jendela konteks

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 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 mencapai batas token.



Endpoint global, multi-region, dan regional

Agent Platform menawarkan tiga jenis endpoint:

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

Endpoint regional dan multi-region dikenakan 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
• Tanpa premium harga
• Terbaik untuk aplikasi di mana residensi data bersifat fleksibel
• Hanya mendukung lalu lintas pay-as-you-go (provisioned throughput memerlukan endpoint regional)

Endpoint multi-region:

• Secara dinamis merutekan permintaan di seluruh region dalam area geografis tertentu (saat ini us dan eu)
• Berguna ketika Anda memerlukan residensi data dalam geografi yang luas tetapi menginginkan ketersediaan yang lebih tinggi daripada satu region
• Premium harga 10% dibandingkan endpoint global
• Hanya mendukung lalu lintas pay-as-you-go (provisioned throughput memerlukan endpoint regional)

Endpoint regional:

• Merutekan lalu lintas melalui region geografis tertentu
• Diperlukan untuk residensi data region tunggal, mandat kepatuhan yang ketat, atau provisioned throughput
• Mendukung pay-as-you-go dan provisioned throughput
• Premium 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 pengidentifikasi 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 lalu lintas di seluruh region dalam geografi 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