claude-opus-5-5 mengirim disabled akan menghasilkan 400, claude-sonnet-5-5 harus beralih ke between_tools

Catatan penulis: Artikel ini disusun berdasarkan dokumentasi resmi Anthropic per 2026-11-08 (UTC+8) serta panduan parameter thinking Claude APIYI yang diperbarui pada 2026-11-09 pukul 10:40, dengan tanggal verifikasi acuan 2026-11-13, guna membantu Anda menghindari error 400 pada parameter thinking di claude-opus-5-5 dan claude-sonnet-5-5.

Jika Anda mengirim type pada thinking sebagai disabled di claude-opus-5-5, antarmuka akan langsung mengembalikan 400—ini ketentuan yang tertulis jelas dalam dokumentasi resmi Anthropic per 2026-11-08 (UTC+8). APIYI (apiyi.com) telah memperbarui panduan parameter thinking Claude secara sinkron pada 2026-11-09 pukul 10:40, merinci penulisan yang benar untuk kedua ID model. Artikel ini mengulas singkat dampak perubahan tersebut bagi pengguna yang memanggil Claude API.

Ini bukan kabar burung: kedua kesimpulan kunci mengacu pada dokumentasi—claude-opus-5-5 tidak bisa mematikan thinking, hanya bisa menurunkan effort; claude-sonnet-5-5 untuk mematikan thinking di awal harus beralih ke between_tools.

Nilai utama: dalam 3 menit pahami penulisan yang benar untuk kedua ID model, batas parameter between_tools, serta cara menelusuri error 400.

Ringkasan cepat: ketentuan thinking pada claude-opus-5-5 dan claude-sonnet-5-5

Lihat tabel kesimpulan dulu, lalu kita bahas satu per satu:

Item informasi	Detail
Ketentuan resmi	2026-11-08 (UTC+8), dokumentasi resmi Anthropic
Pembaruan panduan APIYI	2026-11-09 10:40, docs.apiyi.com sudah disinkronkan
claude-opus-5-5	Tanpa thinking berarti thinking adaptif; jika dikirim disabled akan mengembalikan 400
claude-sonnet-5-5	Tanpa thinking juga thinking adaptif; untuk mematikan pre-thinking gunakan between_tools
Nilai default effort	Opus 5.5 adalah medium, Sonnet 5.5 adalah high
Output maksimum	Kedua ID model sama-sama 128000, token thinking ikut dihitung di dalamnya

Ketentuan claude-opus-5-5 cukup lugas. Kalau field thinking tidak dikirim dalam request, model masuk ke mode thinking adaptif dan memutuskan sendiri apakah akan berpikir pada permintaan itu serta seberapa dalam; begitu type pada thinking di-set ke disabled, API tidak akan diam-diam mengabaikannya, melainkan langsung mengembalikan 400. Dengan kata lain, ID model ini tidak punya tombol untuk mematikan thinking, dan satu-satunya cara penyesuaian yang disebutkan dokumentasi adalah menurunkan effort, dengan tingkat default medium.

Situasi claude-sonnet-5-5 sedikit berbeda. Ia juga mendukung thinking adaptif saat thinking tidak dikirim, tapi ada satu jalur resmi tambahan untuk mematikannya: set type ke between_tools, maka pre-thinking dimatikan dan hanya pembaruan progres di antara pemanggilan tool yang dipertahankan. Batasan jalur ini juga tertulis jelas, sebaiknya langsung bandingkan dengan tabel berikut:

Item batasan	Ketentuan dokumentasi
Nilai effort	Hanya menerima low, medium, high
Batas tingkat	Tidak boleh lebih tinggi dari high
Batasan kombinasi	Tidak boleh membawa display atau budget_tokens sekaligus
Efek sebenarnya	Mematikan pre-thinking, hanya menyisakan pembaruan progres di antara pemanggilan tool

Ada satu detail lain yang mudah terlewat: token thinking dihitung ke dalam max_tokens. Output maksimum kedua ID model adalah 128000, jadi kalau request menekan max_tokens terlalu rendah, thinking bisa memakan sebagian besar anggaran lebih dulu dan isi jawaban pun terpotong. Saat menyelidiki masalah “balasan tiba-tiba jadi lebih pendek”, ada baiknya lebih dulu memastikan seberapa besar pemakaian thinking.

Keterangan gambar: jalur pemanggilan pada diagram menggunakan gateway format native Anthropic dari APIYI apiyi.com sebagai contoh. Saat memakai format Anthropic, alamat base adalah https://api.apiyi.com, perhatikan jangan menulisnya dalam bentuk yang menyertakan /v1.

Analisis dampak: error 400 akibat disabled memengaruhi pemanggil mana saja

Perubahan aturan ini memengaruhi pemanggil di tiga area: penanganan error, kombinasi parameter, dan perencanaan anggaran. Mari kita bahas satu per satu agar lebih jelas.

Dampak pada kode yang sudah ada: migrasi penulisan disabled

Skenario	Penulisan lama	Hasil sekarang	Cara yang benar
claude-opus-5-5 ingin mematikan thinking	mengirim disabled pada type	mengembalikan 400	tidak bisa dimatikan, hanya bisa menurunkan effort
claude-sonnet-5-5 ingin mematikan thinking awal	mengirim disabled pada type	mengembalikan 400	beralih ke between_tools
ingin mengontrol anggaran thinking secara presisi	between_tools dipadukan dengan budget_tokens	kombinasi tidak diterima	keduanya tidak boleh dikirim bersamaan, gunakan tiga tingkat effort
khawatir thinking memakan jatah output	menyetel max_tokens sangat kecil	isi utama terpotong	thinking dihitung dalam max_tokens, sisakan ruang cadangan

Dampak pertama adalah batasan kombinasi parameter yang makin banyak. between_tools tidak bisa muncul bersamaan dengan budget_tokens atau display, artinya cara mengontrol anggaran thinking secara presisi tidak berlaku di jalur ini; Anda hanya bisa mengaturnya secara tidak langsung lewat tiga tingkat low, medium, dan high. Ditambah aturan “token thinking dihitung dalam max_tokens“, pemanggil perlu mencari keseimbangan baru antara effort dan max_tokens.

Dampak kedua adalah logika percabangan harus diperbarui. Jika skrip menentukan apakah akan mengirim disabled berdasarkan ID model, maka untuk kedua ID ini harus ada cabang: yang pertama menerima kenyataan “tidak bisa dimatikan” dan menurunkan tingkat effort; yang kedua beralih ke between_tools. Kelompokkan cabang semacam ini di satu tempat konfigurasi agar perubahan di kemudian hari seminimal mungkin.

Sebagai catatan, halaman yang sama juga menyebutkan bahwa Fable 5.1 dan Fable 5 yang mengirim disabled juga akan menghasilkan 400, sama-sama tidak bisa dimatikan; sedangkan Haiku 5.5 dan Opus 5 masih bisa memakai disabled selama effort tidak lebih tinggi dari high. Jika kode Anda melayani beberapa ID model sekaligus, sebaiknya pelihara matriks sakelar per model, bukan menerapkan penulisan yang sama secara global.

Dampak pada struktur biaya: token thinking dan penggunaan

Harga claude-sonnet-5-5 di tabel utama APIYI (apiyi.com) adalah input $2, output $10, baca cache $0.1. Karena token thinking dihitung dalam max_tokens, apakah thinking awal dimatikan dan tingkat effort mana yang dipilih akan langsung tercermin pada penggunaan token. Pada skenario pemanggilan berfrekuensi tinggi, selisih ini akan makin terasa, jadi ada baiknya menghitungnya sekalian saat mengubah kode.

Keterangan gambar: aturan ini dirangkum dari dokumentasi resmi 2026-11-08, dapat diverifikasi dengan teks aslinya di pusat dokumentasi APIYI apiyi.com.

ID Model	Ketersediaan disabled	Aturan dokumentasi
claude-opus-5-5	tidak tersedia, mengembalikan 400	thinking tidak bisa dimatikan, hanya bisa menurunkan effort (default medium)
claude-sonnet-5-5	tidak tersedia, mengembalikan 400	beralih ke between_tools (default high)
Fable 5.1 / Fable 5	tidak tersedia, mengembalikan 400	sama-sama tidak bisa dimatikan
Haiku 5.5 / Opus 5	tersedia selama effort tidak lebih tinggi dari high	penulisan lama hanya berlaku pada kedua ID ini

Cara Cepat Memverifikasi between_tools pada claude-sonnet-5-5

Sebelum perubahan di-deploy, sebaiknya validasi dulu perbedaan perilakunya dengan trafik kecil. Daftar di APIYI (apiyi.com) dan dapatkan kunci API — pengguna baru mendapat kuota uji gratis. Kirim request ke https://api.apiyi.com, di body request set type pada thinking menjadi between_tools, pilih salah satu dari tiga tingkat effort, jalankan satu putaran dulu, lalu bandingkan dengan mode adaptif yang tidak mengirim thinking, dan amati perubahan struktur output serta penggunaan token.

🚀 Saran verifikasi cepat: dapatkan kuota uji gratis lewat APIYI apiyi.com, lalu jalankan between_tools dan mode adaptif dengan set petunjuk yang sama; pastikan perbedaannya dulu, baru ubah kode yang sudah ada. Platform ini mendukung pemanggilan terpadu untuk model-model populer seperti Claude, OpenAI, dan Gemini, dengan antarmuka yang kompatibel dengan OpenAI dan ditagih berdasarkan pemakaian, sehingga memudahkan perbandingan dan pergantian.

FAQ Pertanyaan Umum: disabled, between_tools, dan error 400

Q1: Apakah claude-opus-5-5 benar-benar bisa mematikan thinking?

Tidak bisa. Pernyataan resmi 2026-11-08 menyebutkan dengan jelas: mengirim `disabled` akan mengembalikan 400. Model ID ini tidak punya saklar untuk mematikan thinking; kedalaman thinking hanya bisa diturunkan lewat `effort`, dan tingkat default-nya adalah `medium`. Kalau skenario memang mengharuskan benar-benar tanpa thinking, satu-satunya jalan adalah mengganti model ID.

Q2: Apakah `between_tools` pada claude-sonnet-5-5 bisa dipadukan dengan `budget_tokens`?

Tidak bisa. Dokumentasi secara eksplisit menyatakan `between_tools` tidak boleh sekaligus membawa `display` atau `budget_tokens`, dan `effort` yang bersangkutan hanya menerima tiga tingkat `low`, `medium`, `high` serta tidak boleh melebihi `high`. Kalau ingin mengontrol anggaran thinking secara detail, satu-satunya jalan adalah kembali ke mode adaptif atau mengganti model ID.

Q3: Kenapa request Claude saya tiba-tiba mengembalikan 400?

Periksa dulu apakah di body request `type` pada `thinking` diset ke `disabled` — pada claude-opus-5-5 dan claude-sonnet-5-5, ini adalah kondisi pemicu yang tertulis di dokumentasi. Setelah dipastikan, tangani sesuai tabel perbandingan di artikel ini: untuk model pertama turunkan `effort`, untuk model kedua pindah ke `between_tools`. Penulisan yang berlaku mengacu pada dokumentasi resmi 2026-11-08 (UTC+8), dan halaman APIYI telah disinkronkan pada 2026-11-09 10:40.

Q4: Bagaimana cara cepat memverifikasi efek `between_tools` pada claude-sonnet-5-5?

Daftar akun di APIYI (apiyi.com) dan dapatkan kunci API — pengguna baru mendapat kuota uji gratis. Kirim request ke `https://api.apiyi.com`, set `type` pada `thinking` menjadi `between_tools`, pilih salah satu tingkat `effort`, lalu jalankan satu putaran; perbedaannya dengan mode adaptif langsung terlihat.

Q5: Apakah token thinking akan memakan anggaran output?

Ya. Token thinking dihitung dalam `max_tokens`, dan output maksimum kedua model ID adalah 128000. Kalau `max_tokens` di request diset terlalu rendah, thinking bisa lebih dulu menghabiskan anggaran sehingga teks utama terpotong; disarankan menyisakan ruang yang cukup untuk teks utama.

claude-opus-5-5 dan claude-sonnet-5-5: Poin-Poin Utama (Key Takeaways)

• claude-opus-5-5 tidak bisa mematikan thinking: mengirim disabled langsung menghasilkan 400, satu-satunya cara adalah menurunkan tingkat effort, dengan default medium.
• claude-sonnet-5-5 beralih ke between_tools: mematikan thinking di awal, hanya menyisakan pembaruan progres di antara pemanggilan tool.
• Tiga batasan parameter: effort hanya low, medium, high, tidak boleh lebih tinggi dari high, serta dilarang dipadukan dengan display dan budget_tokens.
• Aturan anggaran: token thinking dihitung ke dalam max_tokens, kedua ID memiliki batas atas 128000.
• Pintu masuk verifikasi: APIYI apiyi.com, base untuk format Anthropic adalah https://api.apiyi.com, jangan menambahkan /v1.

Ringkasan: Tiga langkah untuk menghindari 400

Cara kerja claude-opus-5-5 dan claude-sonnet-5-5 bisa diringkas menjadi tiga kalimat:

1. claude-opus-5-5: mengirim disabled akan menghasilkan 400, thinking tidak bisa dimatikan, hanya bisa menurunkan effort.
2. claude-sonnet-5-5: matikan thinking di awal dan gunakan between_tools, tiga tingkat effort, dilarang dipadukan dengan display dan budget_tokens.
3. Anggaran: token thinking dihitung ke dalam max_tokens, batas atas 128000, sisakan ruang untuk isi utama.

Jika Anda sedang tertahan oleh error 400 ini, saya sarankan untuk terlebih dahulu menjalankan satu putaran between_tools di APIYI apiyi.com menggunakan kuota uji gratis, pastikan perilakunya baru kemudian mengubah kode yang sudah ada. Platform ini cukup dengan satu kunci API untuk memanggil model-model mainstream seperti OpenAI, Claude, Gemini, dengan penagihan sesuai pemakaian, cocok untuk perbandingan dan pergantian model secara cepat.

📚 Referensi

1. Panduan Parameter Thinking Claude APIYI: cara penggunaan yang tepat untuk effort dan thinking
2. Tautan: docs.apiyi.com/api-capabilities/claude-effort-thinking.md

3. Keterangan: versi yang diperbarui pada 2026-11-09 10:40, sumber fakta utama artikel ini

4. Dinamika Pembaruan Panduan APIYI: penjelasan resmi untuk sinkronisasi standar pada putaran ini

5. Tautan: docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md

6. Keterangan: mencatat proses penyelarasan dengan dokumentasi resmi pada 2026-11-08

7. Dokumentasi Resmi Anthropic: standar asli parameter thinking

8. Tautan: docs.anthropic.com
9. Keterangan: disarankan untuk dibaca berdampingan guna memastikan penulisan terbaru

---

Penulis: Tim Teknis APIYI
Diskusi teknis: Silakan hubungi kami melalui halaman utama situs APIYI. Materi lainnya dapat diakses di pusat dokumentasi docs.apiyi.com

Artikel terkait

• Claude Fable 5.2 vs. Claude Opus 5.5: Mana yang Sebaiknya Dipilih?: Claude Fable 5.2 dibandingkan dengan Claude Opus 5.5: harga standarnya dua kali lipat, tetapi tidak unggul dalam semua aspek; artikel ini menyajikan tabel pemilihan model berdasarkan tugas dari empat aspek: spesifikasi, harga, tingkat upaya default, dan hasil pada artikel peluncuran.
• Sonnet 4.5 akan dihentikan pada 30 November: panduan 5 langkah untuk beralih dari claude-sonnet-4-5 ke Sonnet 5.5: claude-sonnet-4-5 akan dihentikan pada 30 November 2026; artikel ini menggunakan tabel perbandingan dan urutan migrasi lima langkah untuk menjelaskan perubahan ID model, pengali pembacaan cache, dan tagihan saat beralih ke claude-sonnet-5-5, serta cara memverifikasinya dengan permintaan yang sama setelah beralih.