Residensi data

Kontrol "data residency" (residensi data) memungkinkan Anda mengelola di mana data Anda diproses dan disimpan. Dua pengaturan independen mengatur hal ini:

• Inference geo: Mengontrol di mana inferensi model berjalan, berdasarkan per-permintaan. Diatur melalui parameter API inference_geo atau sebagai default workspace.
• Workspace geo: Mengontrol di mana data disimpan saat tidak aktif (at rest) dan di mana pemrosesan endpoint (seperti transcoding gambar dan eksekusi kode) terjadi. Dikonfigurasi di tingkat workspace di Claude Console.



Inference geo

Parameter inference_geo mengontrol di mana inferensi model berjalan untuk permintaan API tertentu. Tambahkan ke panggilan POST /v1/messages mana pun.



Penggunaan API

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[
        {"role": "user", "content": "Summarize the key points of this document."}
    ],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
# Periksa di mana inferensi sebenarnya dijalankan
print(f"Inference geo: {response.usage.inference_geo}")



Respons

Objek usage pada respons menyertakan field inference_geo yang menunjukkan di mana inferensi berjalan:

{
  "usage": {
    "input_tokens": 25,
    "output_tokens": 150,
    "inference_geo": "us"
  }
}



Ketersediaan model

Parameter inference_geo didukung pada Claude 4.6 dan model yang lebih baru. Permintaan dengan inference_geo pada Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, atau model yang lebih lama akan mengembalikan error 400.



Pembatasan tingkat workspace

Pengaturan workspace juga mendukung pembatasan inference geo mana yang tersedia:

• allowed_inference_geos: Membatasi geo mana yang dapat digunakan oleh workspace. Jika sebuah permintaan menentukan inference_geo yang tidak ada dalam daftar ini, API akan mengembalikan error.
• default_inference_geo: Menetapkan geo fallback ketika inference_geo dihilangkan dari permintaan. Permintaan individual dapat menimpa ini dengan menetapkan inference_geo secara eksplisit.

Pengaturan ini dapat dikonfigurasi melalui Console atau Admin API di bawah field data_residency.



Workspace geo

Workspace geo ditetapkan saat Anda membuat workspace dan tidak dapat diubah setelahnya. Saat ini, "us" adalah satu-satunya workspace geo yang tersedia.

Untuk menetapkan workspace geo, buat workspace baru di Console:

1. Buka Settings > Workspaces.
2. Buat workspace baru.
3. Pilih workspace geo.



Harga

Harga residensi data bervariasi berdasarkan generasi model:

• Claude 4.6 dan model yang lebih baru: Inferensi khusus AS (inference_geo: "us") dikenakan harga 1,1x dari tarif standar di semua kategori harga token (input tokens, output tokens, penulisan cache, dan pembacaan cache).
• Routing global (inference_geo: "global"): Harga standar berlaku.
• Model yang lebih lama: Tidak mendukung inference_geo (lihat Ketersediaan model); harga standar berlaku. Permintaan yang menyertakan parameter ini akan mengembalikan error 400.

Harga ini berlaku untuk Claude API (pihak pertama) dan Claude Platform on AWS. Di Claude in Microsoft Foundry, pengali 1,1x yang sama berlaku untuk deployment yang di-hosting di Azure yang menggunakan tipe deployment US Data Zone Standard. Platform yang dioperasikan mitra (Bedrock dan Google Cloud) memiliki harga regional mereka sendiri. Lihat Harga residensi data untuk detailnya.



Dukungan Batch API

Parameter inference_geo didukung pada Batch API. Setiap permintaan dalam sebuah batch dapat menentukan nilai inference_geo-nya sendiri.



Migrasi dari opt-out lama

Jika organisasi Anda sebelumnya memilih keluar (opt-out) dari routing global untuk menjaga inferensi tetap di AS, workspace Anda telah dikonfigurasi secara otomatis dengan allowed_inference_geos: ["us"] dan default_inference_geo: "us". Tidak diperlukan perubahan kode. Persyaratan residensi data Anda yang ada terus diberlakukan melalui kontrol geo yang baru.



Apa yang berubah

Opt-out lama adalah pengaturan tingkat organisasi yang membatasi semua permintaan ke infrastruktur yang berbasis di AS. Kontrol residensi data yang baru menggantikannya dengan dua mekanisme:

• Kontrol per-permintaan: Parameter inference_geo memungkinkan Anda menentukan "us" atau "global" pada setiap panggilan API, memberi Anda fleksibilitas di tingkat permintaan.
• Kontrol workspace: Pengaturan default_inference_geo dan allowed_inference_geos di Console memungkinkan Anda memberlakukan kebijakan geo di semua kunci dalam sebuah workspace.



Apa yang terjadi pada workspace Anda

Workspace Anda dimigrasikan secara otomatis:

Semua permintaan API yang menggunakan kunci dari workspace Anda terus berjalan di infrastruktur yang berbasis di AS. Tidak ada tindakan yang diperlukan untuk mempertahankan perilaku Anda saat ini.



Jika Anda ingin menggunakan routing global

Jika persyaratan residensi data Anda telah berubah dan Anda ingin memanfaatkan routing global untuk kinerja dan ketersediaan yang lebih baik, perbarui pengaturan inference geo workspace Anda untuk menyertakan "global" dalam geo yang diizinkan dan tetapkan default_inference_geo ke "global". Lihat Pembatasan tingkat workspace untuk detailnya.



Dampak harga

Model lama tidak terpengaruh oleh migrasi ini. Untuk harga terkini pada model yang lebih baru, lihat Harga.



Keterbatasan saat ini

• Batas laju bersama: "Rate limit" (batas laju) dibagi di semua geo.
• Inference geo: Hanya "us" dan "global" yang tersedia.
• Workspace geo: Hanya "us" yang saat ini tersedia. Workspace geo tidak dapat diubah setelah pembuatan workspace.



Langkah selanjutnya