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 berjalan, berdasarkan per-permintaan. Diatur melalui parameter API inference_geo atau sebagai default workspace.
• Workspace geo: Mengontrol di mana data disimpan saat istirahat dan di mana pemrosesan endpoint (transcoding gambar, eksekusi kode, dll.) terjadi. Dikonfigurasi di tingkat workspace di Console.

Inference geo

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

Penggunaan API

client = anthropic.Anthropic()

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

print(response.content[0].text)
# Check where inference actually ran
print(f"Inference geo: {response.usage.inference_geo}")

Respons

Objek usage respons mencakup 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 di Claude Opus 4.6 dan semua model berikutnya. Model yang lebih lama dirilis sebelum Opus 4.6 tidak mendukung parameter ini. Permintaan dengan inference_geo pada model legacy 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 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 mengganti 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 diatur ketika 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:

• Claude Opus 4.6 dan lebih baru: Inferensi hanya AS (inference_geo: "us") dihargai pada tingkat 1,1x standar di semua kategori harga token (token input, token output, cache writes, dan cache reads).
• Routing global (inference_geo: "global" atau dihilangkan): Harga standar berlaku.
• Model yang lebih lama: Harga yang ada tidak berubah terlepas dari pengaturan inference_geo.

Harga ini berlaku untuk Claude API (1P) saja. Platform pihak ketiga (AWS Bedrock, Google Vertex AI) memiliki harga regional mereka sendiri. Lihat halaman harga untuk detail.

Dukungan Batch API

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

Migrasi dari opt-out legacy

Jika organisasi Anda sebelumnya memilih untuk tidak menggunakan routing global untuk menjaga inferensi di AS, workspace Anda telah dikonfigurasi secara otomatis dengan allowed_inference_geos: ["us"] dan default_inference_geo: "us". Tidak ada perubahan kode yang diperlukan. Persyaratan residensi data yang ada terus ditegakkan melalui kontrol geo baru.

Apa yang berubah

Opt-out legacy adalah pengaturan tingkat organisasi yang membatasi semua permintaan ke infrastruktur berbasis AS. Kontrol residensi data 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 memberlakukan kebijakan geo di semua kunci dalam workspace.

Apa yang terjadi pada workspace Anda

Workspace Anda dimigrasikan secara otomatis:

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

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 atur default_inference_geo ke "global". Lihat Pembatasan tingkat workspace untuk detail.

Dampak harga

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

Batasan saat ini

• Batas laju bersama: Batas laju dibagikan di semua geo.
• Inference geo: Hanya "us" dan "global" yang tersedia saat peluncuran. Wilayah tambahan akan ditambahkan seiring waktu.
• Workspace geo: Hanya "us" yang saat ini tersedia. Workspace geo tidak dapat diubah setelah pembuatan workspace.

Langkah berikutnya