Claude Models on Google Cloud (Google managed)

Claude Models on Google Cloud membandingkan kedua penawaran Google Cloud. Halaman tersebut juga menunjukkan cara mengetahui penawaran mana yang Anda gunakan.

Sebelum melakukan panggilan API

Untuk menggunakan Claude Models on Google Cloud (Google managed), Anda memerlukan:

1. Proyek Google Cloud yang dapat menggunakan Agent Platform. Untuk langkah-langkah penyiapan, lihat halaman Anthropic Claude models on Agent Platform dari Google Cloud.
2. gcloud CLI yang terinstal, untuk pengembangan lokal.
3. Untuk identitas yang melakukan panggilan, peran IAM yang mencakup izin aiplatform.endpoints.predict, seperti Agent Platform User (roles/aiplatform.user). Untuk detailnya, lihat halaman Agent Platform partner models dari Google Cloud.
4. Kredensial Google Cloud untuk identitas tersebut. Untuk contoh SDK, Anda mungkin perlu menjalankan gcloud auth application-default login untuk melakukan autentikasi dengan Google Cloud. Contoh cURL untuk Claude Models on Google Cloud (Google managed) mendapatkan token-nya dengan gcloud auth print-access-token. Perintah tersebut menggunakan login milik gcloud CLI sendiri, bukan Application Default Credentials. Untuk contoh-contoh tersebut, jalankan gcloud auth login atau gcloud init terlebih dahulu.

Menginstal SDK

SDK klien Anthropic mendukung Claude Models on Google Cloud (Google managed) melalui AnthropicVertex. Instal paket yang menyediakannya:

pip install -U "anthropic[vertex]"

CLI ant tidak mendukung Claude Models on Google Cloud (Google managed).

Membuat permintaan

Permintaan ke Claude Models on Google Cloud (Google managed) dikirim ke URL endpoint Agent Platform yang diakhiri dengan :rawPredict. Permintaan streaming menggunakan :streamRawPredict sebagai gantinya.

Sebuah permintaan hampir identik dengan permintaan Messages API. Perbedaannya terdapat pada dua hal utama:

• Model: URL endpoint menyebutkan nama model. Dalam permintaan cURL, jangan sertakan model di dalam body.
• Versi: Dalam permintaan cURL, teruskan anthropic_version di dalam body, bukan sebagai header. Atur nilainya ke vertex-2023-10-16, atau ke versi API 2026-10-21.

Contoh-contoh berikut menggunakan endpoint global. Untuk jenis endpoint lainnya, lihat Endpoint global, multi-region, dan regional.

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-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

ID model API

Claude Models on Google Cloud (Google managed) menawarkan model Claude yang berbeda di region yang berbeda. Untuk memeriksa model mana yang ditawarkan suatu region, cari "Claude" di Model Garden atau lihat halaman Anthropic Claude models on Agent Platform dari Google Cloud.

Google menetapkan tanggal siklus hidup untuk model-model yang dilayani oleh Claude Models on Google Cloud (Google managed). Tanggal-tanggal ini dapat berbeda dari jadwal Claude API. Untuk tanggal penghentian terkini suatu model, lihat halaman Anthropic Claude models on Agent Platform dari Google Cloud. Untuk arti Deprecated dan Retired, lihat Penghentian model.

Endpoint global, multi-region, dan regional

Claude Models on Google Cloud (Google managed) menawarkan tiga jenis endpoint. Anda memilih salah satunya melalui nilai region yang Anda teruskan saat membuat klien. Dalam permintaan cURL, jenis endpoint menentukan host dan segmen locations dari URL.

Jenis-jenis endpoint berbeda dalam hal ke mana permintaan dikirim:

• Global: Permintaan dikirim ke region mana pun yang memiliki kapasitas tersedia. Gunakan ini ketika Anda menginginkan ketersediaan maksimum dan residensi data bersifat fleksibel.
• Multi-region: Permintaan dikirim ke region mana pun di Amerika Serikat ("us") atau Uni Eropa ("eu"). Gunakan ini ketika Anda memerlukan residensi data dalam wilayah geografis yang luas dan ketersediaan yang lebih tinggi daripada satu region.
• Regional: Permintaan hanya dikirim ke region yang Anda sebutkan, seperti "us-east5" atau "europe-west1". Gunakan ini ketika Anda memerlukan residensi data dalam satu region atau harus memenuhi mandat kepatuhan yang ketat.

Endpoint multi-region dan regional berbiaya 10% lebih mahal daripada endpoint global. Ketiga jenis endpoint menerima lalu lintas pay-as-you-go, dan provisioned throughput memerlukan endpoint regional.

Endpoint regional hanya melayani Claude Sonnet 4.6 dan model-model sebelumnya. Untuk model yang lebih baru, gunakan endpoint global atau multi-region.

Contoh-contoh berikut menggunakan endpoint multi-region us. Baris yang disorot mengatur region. Untuk permintaan lengkap pada endpoint global, lihat Membuat permintaan.

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)

Dukungan fitur

Fitur-fitur yang didukung di Claude Models on Google Cloud (Google managed) meliputi yang berikut:

• Messages API
• "Prompt caching" (caching prompt)
• Thinking
• "Tool use" (penggunaan alat), termasuk alat-alat berikut:
  • Alat bash
  • Alat browser use
  • Alat computer use
  • Alat memori
  • Alat editor teks
  • Alat pencarian web
• Citations
• Structured outputs

Ikhtisar fitur mencantumkan setiap fitur dan apakah Claude Models on Google Cloud (Google managed) mendukungnya.

Fitur yang tidak didukung

Claude Models on Google Cloud (Google managed) tidak mendukung hal-hal berikut:

• Sumber input: Sumber URL untuk gambar dan dokumen, serta Files API
• Alat sisi server: Code execution, web fetch, dan advisor
• Infrastruktur agen: Agent Skills, konektor MCP, dan programmatic tool calling
• Endpoint API: Message Batches API, Models API, Admin API, Compliance API, serta Usage and Cost API
• Claude Managed Agents
• Fallback sisi server: Parameter fallbacks

Sebagai pengganti fallback sisi server, gunakan pola fallback sisi klien.

Jendela konteks

Claude Models on Google Cloud (Google managed) menawarkan "context window" (jendela konteks) 1M token untuk model-model berikut:

• Claude Fable 5.1
• Claude Fable 5
• Claude Opus 5.5
• Claude Opus 5
• Claude Opus 4.8
• Claude Opus 4.7
• Claude Opus 4.6
• Claude Sonnet 5.5
• Claude Sonnet 5
• Claude Sonnet 4.6
• Claude Haiku 5.5

Model Claude lainnya memiliki jendela konteks 200k token. Ini termasuk Claude Sonnet 4.5 (deprecated) dan Claude Sonnet 4 (deprecated).

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

Penagihan, batas laju, dan logging

Batas laju

Google Cloud mengelola "rate limit" (batas laju) dan kuota untuk Claude Models on Google Cloud (Google managed). Untuk detailnya, termasuk cara meminta peningkatan kuota, lihat halaman Quotas for Anthropic Claude models dari Google Cloud.

Penagihan

Google Cloud menagih Anda untuk Claude Models on Google Cloud (Google managed). Untuk harga, lihat halaman Generative AI pricing dari Google Cloud. Harga juga bergantung pada jenis endpoint. Lihat Endpoint global, multi-region, dan regional.

Retensi data

Google Cloud mengatur penanganan data untuk Claude Models on Google Cloud (Google managed). Untuk detailnya, lihat Agent Platform and zero data retention.

Pemantauan dan logging

Untuk mencatat log prompt dan completion untuk Claude Models on Google Cloud (Google managed), gunakan layanan logging permintaan-respons dari Agent Platform.

Anthropic merekomendasikan agar Anda menyimpan setidaknya log 30 hari terakhir. Log tersebut membantu Anda memahami aktivitas Anda dan menyelidiki kemungkinan penyalahgunaan.

Migrasi dari Claude Models on Google Cloud (Anthropic managed)

Untuk mengetahui apa yang berubah saat Anda berpindah, lihat Perbedaan kedua penawaran Google Cloud. Untuk berpindah ke Claude Models on Google Cloud (Google managed), ikuti langkah-langkah berikut:

1. 1

   Siapkan akses

   Periksa bahwa proyek Anda dan identitas yang melakukan panggilan memenuhi persyaratan di Sebelum melakukan panggilan API.

2. 2

   Instal paket SDK

   Instal paket yang menyediakan klien untuk Claude Models on Google Cloud (Google managed). Lihat Menginstal SDK.

3. 3

   Ganti import dan klien

   Ubah kode yang mengimpor dan membuat klien Anda. Gunakan AnthropicVertex sebagai pengganti AnthropicGoogleCloud. Permintaan cURL memerlukan URL baru, header baru, dan body baru. Kode berikut membuat klien untuk Claude Models on Google Cloud (Anthropic managed) yang Anda gunakan saat ini:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   Kode berikut membuat klien untuk Claude Models on Google Cloud (Google managed). Kode ini menggunakan endpoint global. Untuk jenis endpoint lainnya, lihat Endpoint global, multi-region, dan regional.

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   Kode ini meneruskan ID proyek Anda dan sebuah region saat membuat klien. Ganti MY_PROJECT_ID dengan ID proyek Anda. Panggilan Messages API yang Anda lakukan dengan klien tetap seperti semula. Pengecualiannya adalah ID model dan fitur pada langkah berikutnya.

4. 4

   Periksa ID model dan fitur

   • ID model: Jika Anda menggunakan model yang lebih lama dari Claude 4.6, ganti tanda hubung sebelum tanggal snapshot dalam ID-nya dengan @. Misalnya, claude-haiku-4-5-20251001 menjadi claude-haiku-4-5@20251001. Untuk model-model dan ID-nya, lihat ID model API.
   • Fitur: Periksa bahwa fitur yang digunakan kode Anda tidak tercantum di Fitur yang tidak didukung.
5. 5

   Jalankan permintaan uji

   Jalankan permintaan di Membuat permintaan untuk memeriksa bahwa penyiapan Anda berfungsi. Kemudian jalankan kode Anda sendiri. Sebelum Anda memindahkan lalu lintas produksi, baca tentang batas laju untuk Claude Models on Google Cloud (Google managed).

Langkah selanjutnya