Arti error context length exceeded (prompt is too long) dan cara mengatasinya

400Input ditambah output yang diminta melebihi jendela konteks model.

Langkah perbaikan di bawah berlaku untuk key dari OpenAI, Anthropic, Google maupun gateway. Bagian terakhir menjelaskan pesan dan solusinya di Ezkielyna API.

Dicek · Sumber: dokumentasi Ezkielyna API · Gagal = Gratis · halaman status

Artinya

Setiap model punya jendela konteks: jumlah token maksimal untuk input dan output dalam satu request. Kalau riwayat chat, dokumen, hasil tool dan max_tokens dijumlahkan lebih besar dari itu, request ditolak sebelum diproses.

Contoh pesan yang muncul

Teksnya bisa sedikit berbeda antar versi aplikasi dan SDK. Bagian yang ditulis N, M atau nama-model diganti angka atau nama sungguhan.

  • OpenAIThis model's maximum context length is N tokens. However, your messages resulted in M tokens. (code: context_length_exceeded)
  • Anthropicprompt is too long: M tokens > N maximum
  • Google GeminiThe input token count (M) exceeds the maximum number of tokens allowed (N).

Penyebab umum

  • Riwayat percakapan panjang yang terus dikirim ulang.
  • Dokumen, log atau file kode besar ditempel utuh.
  • Gambar dalam base64 dan hasil tool yang panjang di agent coding.
  • max_tokens diatur terlalu besar sehingga input + output melewati batas.

Cara memperbaiki, langkah demi langkah

  1. Kirim riwayat seperlunya. Simpan 4–10 pesan terakhir saja, atau ringkas percakapan lama menjadi satu pesan.
  2. Pecah dokumen. Bagi dokumen menjadi beberapa bagian, ringkas tiap bagian, lalu gabungkan ringkasannya.
  3. Turunkan max_tokens. Minta output secukupnya; output yang dipesan ikut memakan jendela konteks.
  4. Bersihkan sesi agent. Di Claude Code jalankan /compact untuk meringkas atau /clear untuk mulai baru; di Cline dan Roo Code buka tugas baru.
  5. Pilih model dengan konteks lebih besar. Kalau memang butuh konteks panjang, pakai model yang jendelanya lebih besar, dengan sadar bahwa prompt panjang juga lebih mahal.

Di Ezkielyna API

  • Di Ezkielyna, request yang terlalu besar untuk model tujuan dijawab dengan pesan "The request is too large for this model. Shorten the context or attachments." Request di atas 32 MB (biasanya karena gambar) ditolak dengan 413 request_too_large.
  • Konteks panjang juga menaikkan biaya. Halaman biaya ringkas dokumen menghitung biaya per halaman dengan harga live.

Alat bantu: biaya ringkas dokumen · daftar model dan grup

Pertanyaan umum

Apakah error context length memotong saldo?

Biasanya tidak, karena request ditolak sebelum model menjawab. Cek menu Log untuk memastikan.

Bagaimana menghitung token sebelum mengirim?

Patokan kasar: 1 kata bahasa Indonesia sekitar 1,5 token, 1 kata bahasa Inggris sekitar 1,3 token. Untuk angka pasti, lihat kolom token input di log pemakaian.

In English

"Context length exceeded" / "prompt is too long" means input plus requested output is larger than the model's context window. Trim chat history, split documents, lower max_tokens, use /compact or /clear in Claude Code, or pick a model with a larger window. On Ezkielyna, requests over 32 MB return 413 request_too_large.