Residensi data

Kontrol 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 dijalankan, 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 pada tingkat workspace di Claude Console.

Inference geo

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

Penggunaan API

client = anthropic.Anthropic()

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

print(response.content[0].text)
# Periksa di mana inferensi sebenarnya dijalankan
print(f"Inference geo: {response.usage.inference_geo}")

Respons

Objek usage dalam respons menyertakan field inference_geo yang menunjukkan di mana inferensi dijalankan:

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

Ketersediaan model

Parameter inference_geo didukung pada Claude Opus 4.6, Claude Sonnet 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 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 Opus 4.6, Claude Sonnet 4.6, dan yang lebih baru: Inferensi khusus AS (inference_geo: "us") dikenakan harga 1,1x dari tarif standar di semua kategori harga token (token input, token output, penulisan cache, dan pembacaan cache).
• Routing global (inference_geo: "global"): Harga standar berlaku.
• Model 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 (first-party) dan Claude Platform on AWS. Platform yang dioperasikan mitra (Bedrock dan Vertex AI) memiliki harga regional mereka sendiri. Lihat Harga residensi data untuk detailnya.

Dukungan Batch API

Parameter inference_geo didukung pada Batch API. Setiap permintaan dalam 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 berbasis AS. Kontrol residensi data yang baru menggantikan ini dengan dua mekanisme:

• Kontrol per permintaan: Parameter inference_geo memungkinkan Anda menentukan "us" atau "global" pada setiap panggilan API, memberikan Anda fleksibilitas tingkat permintaan.
• Kontrol workspace: Pengaturan default_inference_geo dan allowed_inference_geos di Console memungkinkan Anda menerapkan kebijakan geo di semua kunci dalam 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 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 performa 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.

Batasan saat ini

• Batas laju bersama: 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