Ingin menonaktifkan mode berpikir? claude-haiku-5-5 akan error saat effort lebih tinggi dari high

Catatan penulis: claude-haiku-5-5 secara default akan melakukan thinking, tetapi saat ingin mematikannya malah error? Biasanya karena effort lebih tinggi dari high. Artikel ini menjelaskan aturan, perbaikan tiga langkah, dan batas parameter.

Membuat claude-haiku-5-5 berpikir lebih sedikit dan menyisakan kuota output untuk konten utama adalah kebutuhan yang sangat umum saat menjalankan pemrosesan batch dan tugas terstruktur. Anda mungkin sudah menyetel thinking menjadi disabled, tetapi API malah mengembalikan error: niatnya mematikan thinking, kenapa justru diblokir? Artikel ini akan membahas aturan kerja sama antara effort dan disabled, membantu Anda cepat menguasai cara yang benar untuk menonaktifkan thinking pada claude-haiku-5-5.

Ini bukan masalah mistis, juga bukan model yang tiba-tiba bermasalah. Dokumentasi menjelaskannya dengan jelas: jika thinking tidak dikirim, claude-haiku-5-5 menggunakan thinking adaptif yang aktif secara default; untuk mematikan thinking gunakan type: disabled pada thinking, tetapi penulisan ini hanya diterima ketika effort tidak lebih tinggi dari high. Parameter dalam artikel ini mengacu pada dokumentasi resmi Anthropic tanggal 2026-11-08 (UTC+8), dengan tanggal verifikasi 2026-11-13.

Nilai inti: Setelah membaca artikel ini, Anda akan memahami penyebab sebenarnya dari error, metode perbaikan tiga langkah, serta hubungan antara max_tokens dan token thinking. Setelah itu, di lingkungan mana pun Anda melakukan pemanggilan, Anda tidak akan tersandung aturan ini lagi.

Poin utama claude-haiku-5-5

Kesimpulan ditaruh di depan dulu — pembaca yang buru-buru cukup membaca bagian ini:

Poin	Catatan dokumentasi	Dampaknya bagi Anda
Berpikir aktif secara default	Tanpa mengirim thinking, berarti adaptive thinking, aktif secara default	Ingin menghemat kuota harus mematikannya secara eksplisit
Tombol mati	Setel thinking ke type: disabled	Satu-satunya cara mematikan
Ambang effort	disabled hanya diterima jika effort tidak lebih tinggi dari high	Dipasangkan dengan xhigh atau max akan error
Nilai default effort	Default medium, sama dengan claude-opus-5-5	Selama tidak menaikkannya sendiri, tidak akan kena masalah
Batas kuota	Output maksimum 128000, token berpikir dihitung dalam max_tokens	Berpikir akan menyita ruang teks utama

Penjelasan detail claude-haiku-5-5

Pertama, secara default ia berpikir. claude-haiku-5-5 adalah model yang berjalan dengan kemampuan berpikir secara default: ketika field thinking tidak muncul dalam request, ia berjalan dengan adaptive thinking. Dokumentasi tidak menguraikan detail keputusan mode adaptif, tetapi yang pasti, dalam keadaan default berpikir itu aktif.

Jika skenario Anda adalah tanya-jawab singkat, pelabelan batch, konversi format — tugas-tugas yang tidak terlalu butuh penalaran mendalam — maka token berpikir murni merupakan biaya tambahan. Dokumentasi juga mencatat bahwa token berpikir dihitung dalam max_tokens, dengan output maksimum 128000; semakin banyak berpikir, semakin sedikit kuota yang tersisa untuk teks utama. Inilah asal mula keinginan “mematikan berpikir dan menyisakan kuota untuk teks utama”.

Kedua, mematikan ada syaratnya. Satu-satunya tombol untuk mematikan berpikir adalah menyetel thinking ke type: disabled. Namun dokumentasi juga menyatakan bahwa penulisan ini hanya diterima ketika effort tidak lebih tinggi dari high: ketika effort bernilai medium atau high, semuanya normal; begitu disetel ke xhigh atau max, request akan error. Pedoman perbaikan resminya juga lugas — turunkan effort ke high atau di bawahnya. Jika Anda memanggil claude-haiku-5-5 melalui APIYI apiyi.com, saat menelusuri error semacam ini pun mulailah dari kombinasi pasangan parameter tersebut.

Ketiga, nilai default justru aman. effort default claude-haiku-5-5 adalah medium, sama dengan claude-opus-5-5, sementara sebagian besar model lain default-nya high. Jalur yang biasanya bikin tersandung adalah: migrasi kode dari model lain, terbiasa menaikkan effort secara eksplisit ke xhigh atau max demi mengejar kualitas, lalu sekaligus menambahkan disabled untuk mengendalikan biaya — dua niat itu saling bertabrakan, dan error pun muncul.

Sebaliknya, selama tidak menaikkan effort secara aktif, default medium secara alami memenuhi syarat “tidak lebih tinggi dari high”, sehingga disabled bisa berlaku normal. Ketika perlu membandingkan antar model, di APIYI apiyi.com satu kunci API bisa memanggil beberapa model, jadi tidak perlu bolak-balik mengubah konfigurasi integrasi.

Gambar di atas adalah jalur penelusuran standar; kasus paling umum terhenti di kotak keputusan di tengah: effort melewati batas. Setelah diperbaiki, disarankan untuk menjalankan verifikasi dengan kuota kecil di APIYI apiyi.com, pastikan responsnya normal, baru kemudian masukkan ke lalu lintas produksi.

claude-haiku-5-5 Mulai Cepat: Perbaikan Tiga Langkah

Tidak perlu membuka dokumentasi yang panjang, cukup ikuti tiga langkah di bawah ini, error semacam ini pada dasarnya bisa teratasi:

1. Konfirmasi ID model: model dalam permintaan haruslah claude-haiku-5-5, singkirkan dulu gangguan akibat salah menulis tipe model.
2. Turunkan effort: setel ke high atau lebih rendah. medium adalah nilai default, boleh langsung tidak dikirim; yang penting jangan mengirim xhigh atau max.
3. Lalu matikan thinking: setel thinking ke {"type": "disabled"}. Pada kondisi ini effort tidak lebih tinggi dari high, permintaan akan diterima dengan normal.

Referensi Cepat Parameter Permintaan claude-haiku-5-5

Parameter	Nilai yang Disarankan	Keterangan
model	claude-haiku-5-5	Tipe model yang dibahas di artikel ini, hati-hati jangan menulis versi lain
thinking	{"type": "disabled"}	Satu-satunya saklar untuk mematikan thinking
effort	medium (default) atau high	Harus tidak lebih tinggi dari high, jika tidak akan bertentangan dengan disabled
Nilai terlarang effort	xhigh, max	Dikombinasikan dengan disabled akan menimbulkan error
max_tokens	Batas atas 128000	Token thinking dihitung ke dalam nilai ini, setelah thinking dimatikan sepenuhnya bisa dialokasikan untuk teks utama

Informasi di sisi integrasi juga tidak rumit, dengan APIYI sebagai contoh:

• Alamat akses: https://api.apiyi.com/v1
• Metode autentikasi: cukup satu kunci API
• Gaya antarmuka: antarmuka kompatibel OpenAI
• Metode penagihan: penagihan sesuai pemakaian, harga terjangkau, pengguna baru mendapat kuota uji gratis
• Cakupan: model-model populer seperti OpenAI, Claude, Gemini

🚀 Mulai Cepat: Disarankan untuk menyelesaikan verifikasi ini di APIYI apiyi.com. Setelah mendaftar, jalankan permintaan yang sudah diperbaiki dengan kuota uji gratis, pastikan disabled berlaku dengan normal dan error hilang, lalu integrasikan ke bisnis nyata, dalam beberapa menit semuanya bisa tuntas.

Kompatibilitas effort claude-haiku-5-5

Tabel berikut adalah yang paling perlu diingat dari seluruh artikel, sebaiknya langsung disimpan ke catatan tim:

Nilai effort	Kombinasi dengan disabled	Hasil
medium (default)	Kompatibel	Berhasil menonaktifkan thinking
high	Kompatibel	Berhasil menonaktifkan thinking
xhigh	Konflik	Permintaan menghasilkan error
max	Konflik	Permintaan menghasilkan error

Bandingkan tabel ini dengan permintaan Anda sendiri, arahnya jadi sangat jelas: selama error muncul pada permintaan yang juga mengirimkan disabled, reaksi pertama adalah memeriksa apakah effort sudah melewati batas high. Perbaikan yang tercatat dalam dokumentasi hanya satu kalimat—turunkan effort ke high atau lebih rendah, tidak ada cara lain untuk menghindarinya.

Perbandingan effort default claude-haiku-5-5 dengan model lain

Model	effort default	Hubungan dengan menonaktifkan thinking
claude-haiku-5-5	medium	Nilai default memenuhi “tidak lebih tinggi dari high”, disabled bisa langsung berlaku
claude-opus-5-5	medium	Nilai default sama dengan haiku, aturan sakelar thinking-nya tidak dibahas di artikel ini
Sebagian besar model lainnya	high	Nilai default juga berada dalam ambang batas, hanya akan melewati batas jika dinaikkan secara manual

Tabel ini menjelaskan “kenapa justru permintaan saya yang error”: nilai default effort berbeda antar model. Saat memigrasikan kode, mengikuti kebiasaan parameter lama bisa dengan mudah membuat effort diatur secara eksplisit ke xhigh atau max. Sebelum migrasi, bandingkan dengan nilai default—itu langkah pencegahan dengan biaya terendah.

Daftar Periksa untuk Pemecahan Masalah dan Pemeriksaan Mandiri Kesalahan claude-haiku-5-5

Gejala	Kemungkinan Penyebab Terbesar	Cara Menangani
Mengirim disabled tetapi masih error	effort bernilai xhigh atau max	Turunkan effort ke high atau lebih rendah
Tidak yakin berapa nilai effort	Jika tidak dikirim, defaultnya medium	Nilai default memenuhi syarat, tidak perlu penanganan tambahan
Isi teks menjadi lebih pendek atau terpotong	Token pemikiran (thinking) dihitung dalam max_tokens	Matikan thinking, atau perbesar max_tokens dalam batas maksimum 128000
Ingin kualitas penalaran yang lebih mendalam	Proses berpikir hilang setelah thinking dimatikan	Hapus disabled, kembali ke thinking adaptif default

Setelah diperbaiki, jalankan daftar periksa mandiri ini sebelum mengirim permintaan:

• model ditulis dengan tepat sebagai claude-haiku-5-5
• effort tidak diisi, atau secara eksplisit bernilai medium atau high
• thinking bernilai {"type": "disabled"}
• max_tokens tidak melebihi 128000

Jika keempat syarat terpenuhi, kesalahan jenis ini tidak akan muncul lagi. Dengan memadatkan kombinasi parameter akhir menjadi template permintaan, Anda juga dapat menghindari perubahan yang tidak disengaja di kemudian hari.

FAQ Pertanyaan Umum claude-haiku-5-5

Q1: Apakah claude-haiku-5-5 berpikir secara default?

Ya. Dokumentasi menyebutkan bahwa jika `thinking` tidak dikirim, claude-haiku-5-5 berjalan dengan penalaran adaptif yang aktif secara default. Kalau ingin seluruh kuota output dipakai untuk teks utama, kamu perlu secara eksplisit mengirim `disabled` untuk mematikannya.

Q2: Kenapa sudah mengirim disabled tapi masih error?

Penyebab paling umum adalah `effort` yang lebih tinggi dari `high`. Dokumentasi menyatakan `disabled` hanya diterima saat `effort` tidak lebih tinggi dari `high`; kalau dipasangkan dengan `xhigh` atau `max` akan muncul error. Solusinya adalah menurunkan `effort` ke `high` atau di bawahnya.

Q3: Apa yang terjadi kalau effort tidak dikirim?

Nilai default-nya `medium`. claude-haiku-5-5 dan claude-opus-5-5 punya default yang sama, yaitu `medium`, sementara sebagian besar model lain default-nya `high`. Nilai default ini sendiri sudah memenuhi syarat “tidak lebih tinggi dari high”, jadi bisa langsung dipasangkan dengan `disabled`.

Q4: Setelah penalaran dimatikan, bagaimana perubahan panjang output?

Dokumentasi mencatat bahwa token penalaran dihitung ke dalam `max_tokens`, dengan output maksimum 128000. Setelah penalaran dimatikan, anggaran `max_tokens` yang sama bisa sepenuhnya dipakai untuk teks utama, sehingga risiko terpotong juga menurun.

Q5: Bagaimana kalau sewaktu-waktu ingin penalaran yang lebih dalam?

Hapus `disabled`, biarkan claude-haiku-5-5 kembali ke penalaran adaptif default. Kalau ingin sekaligus menaikkan `effort`, perhatikan jangan sampai berhenti pada kombinasi “`xhigh` atau `max` ditambah `disabled`”.

Q6: Bagaimana cara cepat memverifikasi apakah perbaikan sudah berlaku?

Setelah mendaftar di APIYI apiyi.com dan mendapatkan kuota uji gratis, gunakan alamat `https://api.apiyi.com/v1`, lalu jalankan sekali dengan parameter yang sudah diperbaiki: kalau permintaan tidak lagi error dan teks utama kembali normal, berarti `disabled` sudah berlaku. Platform menagih sesuai pemakaian, jadi biaya verifikasi dengan kuota kecil sangat murah.

Q7: Apakah error pasti berasal dari effort?

Belum tentu, tapi ini salah satu kategori yang tercatat jelas di dokumentasi. Pertama periksa apakah `model` sudah ditulis dengan benar sebagai `claude-haiku-5-5`, lalu cek apakah kombinasi `thinking` dan `effort` melampaui batas. Setelah keduanya tersisihkan, baru telusuri penyebab lain. Saat menemui error ketika memanggil lewat APIYI, mulailah juga dari pasangan parameter ini.

Q8: Acuan parameter ini mengikuti versi yang mana?

Artikel ini mengacu pada dokumentasi resmi Anthropic per 2026-11-08 (UTC+8), dengan tanggal pemeriksaan 2026-11-13. Jika pihak resmi menyesuaikan aturan `effort` dan `disabled` di kemudian hari, ikuti dokumentasi terbaru.

Ringkasan

Ada empat poin inti soal menonaktifkan thinking di claude-haiku-5-5:

1. Aktif secara default: kalau tidak mengirim thinking, itu berarti adaptive thinking yang menyala secara default — untuk menghemat kuota, harus dimatikan secara eksplisit.
2. Menonaktifkan ada syaratnya: ketika thinking diset disabled, effort tidak boleh lebih tinggi dari high; memasangkannya dengan xhigh atau max akan memunculkan error.
3. Default sudah aman: effort default-nya medium, sama seperti claude-opus-5-5 — selama tidak menaikkannya sendiri, konflik tidak akan terjadi.
4. Batas kuota: output maksimum 128000, token thinking ikut dihitung dalam max_tokens; setelah dimatikan, seluruh kuota tersedia untuk teks jawaban.

Lain kali kalau bertemu kasus “mau matikan thinking tapi malah error”, cek dulu apakah effort sudah melewati garis high, lalu rapikan kombinasi parameternya — biasanya masalahnya langsung selesai. Disarankan memakai kuota uji gratis lewat APIYI apiyi.com untuk memverifikasi hasilnya dengan cepat; satu kunci API saja sudah cukup untuk memanggil claude-haiku-5-5 dan berbagai model populer lainnya, dan antarmuka yang kompatibel dengan OpenAI juga membuat pergantian model jauh lebih praktis.

📚 Referensi

1. Dokumentasi APIYI: Penjelasan parameter effort dan thinking pada Claude
2. Tautan: docs.apiyi.com/api-capabilities/claude-effort-thinking.md

3. Keterangan: nilai effort, syarat penerimaan disabled, dan format pesan error

4. Dokumentasi APIYI: Pembaruan panduan thinking Claude (2026-11)

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

6. Keterangan: catatan pembaruan dan latar belakang panduan terkait thinking

7. Dokumentasi resmi Anthropic

8. Tautan: docs.anthropic.com
9. Keterangan: parameter dalam artikel ini mengacu pada versi resmi per 2026-11-08 (UTC+8)

---

Penulis: Tim Teknis APIYI
Diskusi teknis: silakan hubungi kami melalui halaman utama situs APIYI; materi lainnya dapat diakses di pusat dokumentasi