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, per permintaan. Diatur melalui parameter API inference_geo atau sebagai default workspace.
• Workspace geo: Mengontrol di mana data disimpan saat diam (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 model Claude 4.6 dan 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 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 permintaan menentukan inference_geo yang tidak ada dalam daftar ini, API mengembalikan error.
• default_inference_geo: Menetapkan geo fallback ketika inference_geo dihilangkan dari permintaan. Permintaan individual dapat menimpanya 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 menurut generasi model:

• Model Claude 4.6 dan yang lebih baru: Inferensi khusus AS (inference_geo: "us") dikenakan harga 1,1x tarif standar di semua kategori harga token (token input, token output, penulisan cache, dan pembacaan cache).
• Perutean global (inference_geo: "global"): Harga standar berlaku.
• Model lama: Tidak mendukung inference_geo (lihat Ketersediaan model); harga standar berlaku. Permintaan yang menyertakan parameter ini 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 sendiri. Lihat Harga residensi data untuk detailnya.

Pengali yang sama berlaku untuk Claude Managed Agents: ketika konfigurasi model agen menyematkan inference_geo ke "us", permintaan model dalam sesi yang menjalankan agen tersebut dikenakan harga 1,1x tarif standar.

Dukungan Batch API

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

Migrasi dari opt-out lama

Jika organisasi Anda sebelumnya memilih keluar (opt-out) dari perutean 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 sudah ada terus diberlakukan melalui kontrol geo yang baru.

Apa yang berubah

Opt-out lama adalah pengaturan tingkat organisasi yang membatasi semua permintaan ke infrastruktur berbasis 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 berbasis AS. Tidak diperlukan tindakan apa pun untuk mempertahankan perilaku Anda saat ini.

Jika Anda ingin menggunakan perutean global

Jika persyaratan residensi data Anda telah berubah dan Anda ingin memanfaatkan perutean global untuk performa dan ketersediaan yang lebih baik, perbarui pengaturan inference geo workspace Anda agar 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 bersama di semua geo.
• Inference geo: Hanya "us" dan "global" yang tersedia.
• Workspace geo: Hanya "us" yang tersedia saat ini. Workspace geo tidak dapat diubah setelah pembuatan workspace.

Langkah selanjutnya