Claude API Versi 2026-10-21: Apa yang Berubah dan Cara Upgrade dengan Aman

Claude API versi 2026-10-21 adalah nilai anthropic-version baru pertama sejak 2023-06-01. Versi ini membawa tiga perubahan breaking pada Messages API: temperature, top_p, dan top_k kini mengembalikan error 400, blok document dalam pesan assistant mengembalikan 400, dan citations pada blok text dalam pesan user mengembalikan 400. Versi ini juga mengganti nama beberapa field Admin API dan Enterprise Analytics API. Anda memilih ikut (opt in) dengan mengirim anthropic-version: 2026-10-21 atau dengan melakukan upgrade ke major SDK yang baru (Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, dan lainnya).

Masalahnya: melakukan upgrade SDK adalah cara sebagian besar tim "tanpa sengaja" berpindah ke versi baru. Perintah rutin pip install -U anthropic atau npm update yang melewati sebuah major version akan langsung mengalihkan setiap request ke 2026-10-21. Panduan ini mencantumkan setiap perubahan yang didokumentasikan Anthropic, menunjukkan mana yang menggigit di kode nyata, dan memberi Anda urutan upgrade yang aman.

Apa itu header anthropic-version?

Header anthropic-version adalah header request wajib yang mematok bentuk Claude API yang Anda terima. Dalam satu versi, Anthropic menjaga parameter input dan output yang sudah ada tetap stabil, tetapi dapat menambahkan input opsional, nilai output baru, varian enum baru seperti tipe event streaming, dan kondisi error baru. Perubahan breaking hanya datang bersama tanggal versi baru.

Dari halaman versioning, ada tiga versi:

Jika Anda menggunakan SDK resmi, Anda tidak pernah mengatur header itu sendiri. Setiap major SDK mengirim versi yang berlaku saat major tersebut dirilis. Itulah sebabnya upgrade SDK dan upgrade versi API menjadi peristiwa yang sama bagi sebagian besar codebase.

Perubahan breaking pada Claude API 2026-10-21

Perubahan-perubahan ini berlaku untuk POST /v1/messages, untuk penghitungan token, dan untuk setiap request di dalam Message Batch yang dibuat dengan 2026-10-21.

1. temperature, top_p dan top_k dihapus

Inilah perubahan yang paling banyak dihadapi orang. Setiap request yang mengirim temperature, top_p, atau top_k mengembalikan error 400, pada semua model, bahkan jika Anda mengirim nilai default. Satu temperature: 1.0 yang tertinggal di file konfigurasi saja sudah cukup untuk membuat pemanggilan gagal.

Apa yang terjadi pada kualitas output bergantung pada modelnya:

• Claude 4.7 dan yang lebih baru sudah hanya menerima nilai sampling default, jadi menghapus parameter tersebut tidak mengubah cara mereka melakukan sampling.
• Model lama yang menerima nilai lain, seperti Claude Sonnet 4.6, kehilangan efek apa pun yang Anda dapatkan dari menurunkan temperature. Panduan migrasi menyatakannya dengan gamblang: tidak ada pengaturan lain yang menggantikannya.

Jika sebuah request benar-benar bergantung pada nilai non-default, Anthropic memberi Anda dua pilihan: berhenti mengirimkannya, atau pertahankan request khusus itu pada 2023-06-01.

2. Blok document dalam pesan assistant mengembalikan 400

Sebagian aplikasi memutar ulang riwayat percakapan dengan blok document yang berada langsung di dalam giliran assistant. Pada 2026-10-21 hal itu ditolak. Pindahkan dokumen ke pesan user. Dokumen yang bersarang di dalam blok lain, seperti hasil tool web fetch yang dikembalikan Claude, masih diterima.

3. citations dalam pesan user mengembalikan 400

Blok text dengan array citations yang tidak kosong di dalam pesan user kini gagal, termasuk teks di dalam blok search_result. Hapus citations dari blok-blok tersebut. Citations pada balasan assistant milik Claude sendiri yang Anda kirim kembali masih boleh, begitu juga "citations": {"enabled": true} pada dokumen dan hasil pencarian.

4. Penggantian nama field Admin API dan Enterprise Analytics

Respons tidak lagi menyertakan nama field lama:

Perubahan pada kunci API adalah yang paling halus. Pada 2023-06-01, workspace_id bernilai null baik untuk kunci yang terikat ke Default Workspace maupun untuk kunci semua-workspace. Pada 2026-10-21, scope.workspace_id berisi ID asli Default Workspace, dan kunci semua-workspace memiliki scope: {"type": "organization"} tanpa workspace_id. Jika dasbor Anda memperlakukan null sebagai "Default Workspace", dasbor tersebut akan salah memberi label pada kunci setelah upgrade.

Versi SDK yang mengirim 2026-10-21

Anthropic merilis major SDK baru pada 21 Oktober 2026, dan masing-masing mengirim 2026-10-21 secara default, sesuai catatan rilis:

Major baru juga membawa perubahan yang sama sekali tidak bergantung pada versi API:

• Kunci API dikirim sebagai Authorization: Bearer <key> alih-alih X-Api-Key. Claude API menerima keduanya, tetapi proxy, gateway, filter log, atau stub pengujian yang membaca X-Api-Key tidak akan lagi melihat kunci tersebut.
• Text Completions dihapus dari SDK TypeScript, Go, Java, dan Ruby serta dari CLI. Gunakan Messages API.
• betas hilang dari metode Models non-beta. Panggil client.beta.models sebagai gantinya.
• MessageParam adalah union dengan satu tipe per peran di SDK bertipe, jadi beberapa anotasi tipe perlu diperbarui.
• Go memerlukan jalur import baru yang berakhiran /v2, dan pengguna TypeScript pada paket Bedrock, Vertex, Foundry, AWS, atau Google Cloud harus memindahkan paket-paket tersebut ke v1 dalam upgrade yang sama, atau package manager akan memasang salinan kedua SDK inti yang lebih lama.
• Lisensinya berubah dari MIT menjadi Apache 2.0.

Pin major Anda saat ini sebelum melakukan hal lain. Itu mencegah bot dependensi melakukan upgrade di tengah sprint.

Pengecualian Amazon Bedrock

Di Amazon Bedrock, 2026-10-21 hanya berfungsi dengan model Claude 4.7 dan yang lebih baru. Jika Anda masih memanggil Opus 4.6 atau model yang lebih lama di sana, tetap gunakan versi SDK Anda saat ini atau terus kirim header Anda saat ini, dan ganti modelnya terlebih dahulu.

Cara upgrade ke Claude API versi 2026-10-21 dengan aman

Urutan dalam panduan migrasi adalah: ganti versinya, perbaiki perubahan breaking-nya, uji sebelum rilis. Berikut bentuknya dalam praktik.

1. Pin major SDK lama. Misalnya anthropic<2 di Python atau "@anthropic-ai/sdk": "^0" di npm.
2. Cari di kode dan konfigurasi Anda kata temperature, top_p, top_k, X-Api-Key, completions.create, dan setiap field Admin API dari tabel di atas.
3. Putuskan soal sampling. Pada Claude 4.7 dan yang lebih baru, hapus parameternya. Pada model lama, terima saja sampling default atau pertahankan panggilan tersebut pada 2023-06-01.
4. Perbaiki konstruksi pesan. Pindahkan dokumen di sisi assistant ke giliran user dan hapus citations dari blok teks user.
5. Uji payload yang sama di kedua versi dan bandingkan kode status serta bentuk responsnya.
6. Upgrade SDK dan rilis perbaikan kode secara bersamaan. Anthropic menyarankan merilis upgrade bersama perbaikan Anda, bukan sebelumnya.

Tanpa SDK, peralihannya cukup satu header:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Tambahkan "temperature": 0.2 ke body itu dan Anda akan mendapat 400. Kirim body yang sama dengan anthropic-version: 2023-06-01 dan request itu berhasil. Pasangan hasil itulah yang seharusnya ditangkap langkah 5 untuk setiap payload yang Anda kirim ke produksi.

Biarkan Claude Code menguji kedua versi dengan Apidog CLI

Langkah 5 melelahkan jika dilakukan manual: Anda punya puluhan bentuk payload, dan masing-masing perlu dijalankan dua kali. Serahkan saja ke coding agent Anda. Apidog CLI memberi Claude Code (atau Codex, Cursor, dan OpenCode) perintah untuk membuat test case dan menjalankannya, sehingga agent yang melakukan perbandingan dan Anda cukup membaca ringkasannya.

Siapkan sekali saja:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

Lalu berikan satu prompt ke Claude Code:

In Apidog project <id>, create an environment "claude-api" with base URL
https://api.anthropic.com. For each JSON payload in ./fixtures/claude/, add a
POST /v1/messages test case that sends the header anthropic-version: {{anthropic_version}}
and asserts status 200 and a non-empty content array. Run every case twice, once with
anthropic_version=2023-06-01 and once with 2026-10-21, and list each case that passes
on the old version but fails on the new one, with the error message.

Agent memeriksa skema setiap payload sebelum menulis apa pun, lalu menjalankan case-nya:

apidog environment create claude-api --project <id> --base-url https://api.anthropic.com
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2023-06-01" -r cli,json
apidog run --test-case <caseId> --project <id> -e <envId> --env-var "anthropic_version=2026-10-21" -r cli,json

Flag --env-var menukar nilai header tanpa menyentuh test case, jadi diff-nya hanya satu variabel. Tambahkan --upload-report untuk melihat kedua run di aplikasi Apidog, atau pasang run 2026-10-21 di CI dengan -r junit agar kenaikan dependensi tidak bisa mengirim field temperature ke produksi. Panduan Apidog CLI di Claude Code membahas penyiapannya lebih rinci, dan referensi apidog run mencantumkan setiap flag. Paket Free Apidog mencakup hingga 4 pengguna.

Apakah 2023-06-01 deprecated?

Belum ada tanggal penghentian yang dipublikasikan. Halaman versioning mencantumkan 2023-06-01 tanpa pemberitahuan deprecation, dan panduan migrasinya sendiri menyarankan Anda mempertahankan request yang memerlukan temperature non-default pada 2023-06-01. Anthropic tetap merekomendasikan versi terbaru "kapan pun memungkinkan".

Hal itu penting untuk perencanaan. Upgrade hari ini bersifat opsional, tetapi 2026-10-21 adalah versi baru pertama dalam lebih dari tiga tahun, dan perubahan breaking di masa depan akan datang dengan cara yang sama, jadi memperlakukan pengujian versi sebagai pekerjaan CI rutin sekarang lebih murah daripada migrasi yang terburu-buru nanti. Jika Anda sudah melakukan tuning seputar batas laju Claude API atau biaya Claude API, tambahkan pemeriksaan versi ke pipeline yang sama. Panduan kami tentang praktik terbaik versioning API menjelaskan mengapa versi berbasis tanggal seperti ini membuatnya lebih mudah.

FAQ

Apakah saya harus upgrade ke Claude API versi 2026-10-21 sekarang?

Tidak. 2023-06-01 masih berfungsi dan belum ada tanggal penghentian yang dipublikasikan. Anda baru upgrade ketika mengirim header baru atau memasang major SDK yang menggunakannya sebagai default.

Mengapa request saya mengembalikan 400 setelah upgrade SDK?

Major SDK baru mengirim 2026-10-21, yang menolak temperature, top_p, dan top_k, blok document di sisi assistant, dan citations pada blok teks user. Periksa dulu payload Anda untuk hal-hal tersebut.

Bisakah saya mempertahankan temperature pada sebagian request?

Bisa, dengan mempertahankan request khusus tersebut pada 2023-06-01. Pada 2026-10-21 tidak ada pengaturan pengganti, dan model Claude 4.7 dan yang lebih baru hanya melakukan sampling dengan nilai default.

Apakah 2026-10-21 berfungsi di Amazon Bedrock?

Hanya untuk model Claude 4.7 dan yang lebih baru. Model Bedrock lama memerlukan versi SDK atau header Anda saat ini sampai Anda mengganti modelnya.

Apakah proxy saya masih akan melihat kunci API saya?

Tidak, jika proxy tersebut membaca X-Api-Key. SDK baru mengirim kunci sebagai Authorization: Bearer. Perbarui proxy agar membaca Authorization, atau konfigurasikan SDK untuk mengirim X-Api-Key sendiri.

Apakah versi baru mengubah event streaming?

Anthropic tidak mencantumkan perubahan format streaming untuk 2026-10-21. Format streaming yang Anda gunakan saat ini sudah ada sejak 2023-06-01.