Perbaiki “Gagal Terhubung ke api.anthropic.com: ERR_BAD_REQUEST”

Diterbitkan: 2025-11-05

Mengalami kesalahan koneksi, terutama saat bekerja dengan API seperti api.anthropic.com , dapat mengganggu dan membuat frustrasi, terutama jika proyek Anda sangat bergantung pada akses dan komunikasi real-time. Salah satu masalah yang sering dilaporkan adalah kesalahan “Gagal Terhubung ke api.anthropic.com: ERR_BAD_REQUEST” . Kesalahan khusus ini menunjukkan masalah pada cara permintaan dikirim atau cara ditangani oleh server, biasanya mengarah pada kesalahan konfigurasi, header yang salah, atau masalah pemformatan permintaan.

TL;DR

Kesalahan “ERR_BAD_REQUEST” biasanya berasal dari permintaan API yang salah, header yang salah, atau masalah otentikasi. Untuk memperbaikinya, periksa URL titik akhir, pastikan header permintaan yang diperlukan (seperti kunci API) dikonfigurasi dengan benar, dan validasi format isi—terutama di JSON. Selain itu, verifikasi pengaturan jaringan Anda, konfigurasi firewall/proxy yang aktif, dan apakah versi API Anda adalah yang terbaru. Mengikuti diagnostik langkah demi langkah dapat menunjukkan dan menyelesaikan masalah secara efisien.

Memahami Kesalahan “ERR_BAD_REQUEST”.

Kesalahan ini adalah bagian dari kelompok kesalahan tingkat HTTP 400 yang lebih luas, yang umumnya menandakan bahwa permintaan yang dikirim ke server tidak valid atau “buruk” dalam struktur, sintaksis, atau pengkodeannya. Secara khusus, dalam konteks ini, ini muncul ketika mencoba berinteraksi dengan API Anthropic—biasanya digunakan untuk model bahasa AI seperti Claude—melalui HTTP atau HTTPS.

“ ERR_BAD_REQUEST ” tidak selalu jelas dan dapat disebabkan oleh berbagai masalah. Mulai dari kesalahan sisi klien, seperti JSON yang salah format atau header yang hilang, hingga kesalahan konfigurasi jaringan pada perangkat pengguna atau masalah server dari sisi Anthropic yang mungkin tidak Anda kendalikan.

Panduan Langkah demi Langkah untuk Memperbaiki Kesalahan

1. Periksa URL Titik Akhir

Pastikan Anda menggunakan nama domain yang benar dan sepenuhnya memenuhi syarat. Titik akhir resmi untuk Anthropic API biasanya:

 https://api.anthropic.com/v1/complete

Periksa URL dasar Anda di konfigurasi klien atau cuplikan kode. Pastikan tidak ada garis miring kecuali ditentukan, dan nomor versi (misalnya, /v1/ ) benar untuk tujuan penggunaan Anda.

2. Pastikan Kunci API Disertakan dan Benar

Kunci API yang hilang atau salah adalah salah satu penyebab paling umum dari kesalahan ini. API Anthropic memerlukan kunci API yang disertakan dalam header Authorization permintaan HTTP Anda.

Contoh:

 Authorization: Bearer YOUR_API_KEY_HERE

Jika kunci API Anda sudah habis masa berlakunya, formatnya tidak bagus, atau headernya salah eja, permintaan mungkin gagal dengan respons “permintaan buruk”.

3. Validasi Header Permintaan Anda

Selain header Authorization , Anda perlu mengatur header Content-Type dengan benar:

 Content-Type: application/json

Header ini tidak ada atau penggunaan tipe MIME yang salah (seperti text/plain atau application/x-www-form-urlencoded) mungkin menyebabkan permintaan Anda terhenti.

4. Periksa Format Muatan

Seringkali, pengguna lupa membuat serial payload dengan benar sebagai JSON, atau mereka menyertakan nilai yang salah atau kunci yang hilang. Berikut ini contoh yang benar dalam mengirimkan payload POST ke titik akhir /complete :

 { "model": "claude-v1", "prompt": "Explain quantum physics in simple terms.", "max_tokens_to_sample": 200 }

Pastikan nama atribut dan tipe data sesuai dengan yang diharapkan API. Penyimpangan apa pun, seperti penggunaan tanda kutip tunggal dan bukan tanda kutip ganda, dapat mengakibatkan format permintaan salah.

5. Periksa Masalah Firewall atau Proxy

Jika Anda beroperasi di belakang proxy atau firewall, konfigurasi tersebut dapat mencegat, mengubah, atau memblokir lalu lintas HTTP. Di beberapa lingkungan perusahaan, koneksi HTTPS keluar memerlukan daftar putih atau autentikasi tambahan.

  • Coba sambungkan tanpa proxy (jika ada).
  • Gunakan alat seperti curl atau Postman untuk menguji koneksi langsung.
  • Pastikan port 443 terbuka untuk permintaan HTTPS keluar.

6. Tes Menggunakan Curl atau Tukang Pos

Menggunakan alat pengujian API seperti Postman atau utilitas baris perintah curl dapat membantu menghilangkan masalah dalam kode aplikasi atau lingkungan pengembangan Anda.

 curl https://api.anthropic.com/v1/complete \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-v1","prompt":"Hi there","max_tokens_to_sample":100}'

Jika alat ini berfungsi tetapi kode Anda tidak, kemungkinan masalahnya ada pada aplikasi Anda.

7. Periksa Versi API dan Penghentian

Anthropic dapat mengubah atau membuat versi API-nya seiring waktu. Jika Anda menggunakan titik akhir yang sudah ketinggalan zaman atau struktur yang tidak digunakan lagi, Anda mungkin mengalami masalah. Kunjungi dokumentasi resmi Anthropic API dan konfirmasikan bahwa Anda menggunakan versi titik akhir terbaru dengan skema yang didukung.

8. Tinjau Log Respons Server

Kapan pun memungkinkan, periksa isi respons HTTP yang dikembalikan bersama kesalahan. Seringkali, bahkan dengan kesalahan 400, isi menyertakan respons berformat JSON yang menunjukkan bidang atau bagian permintaan mana yang menyebabkan masalah.

Contoh:

 { "error": { "message": "prompt is required", "type": "invalid_request_error" } }

9. Perbarui (atau Turunkan Versi) Klien HTTP Anda

Beberapa masalah muncul karena bug pada pustaka HTTP yang digunakan—terutama di lingkungan atau SDK yang kurang dikelola. Coba perbarui pustaka klien HTTP Anda (misalnya, Axios, permintaan Python, pengambilan, dll.) atau uji dengan pustaka lain sepenuhnya.

10. Hubungi Dukungan Antropik Jika Semuanya Gagal

Jika masalah tetap ada meskipun konfigurasi sudah benar, akses diautentikasi, dan permintaan divalidasi, masalahnya mungkin ada di pihak Anthropic. Hubungi tim dukungan Anthropic, idealnya dengan:

  • Muatan dan titik akhir permintaan yang tepat
  • Pesan kesalahan lengkap dan jejak tumpukan
  • Stempel waktu dan ID permintaan (jika tersedia)

Pertanyaan yang Sering Diajukan (FAQ)

Q1: Apa sebenarnya arti “ERR_BAD_REQUEST”?

Artinya permintaan yang dikirim ke server tidak valid. Hal ini mungkin disebabkan oleh header yang salah, format JSON yang salah, endpoint yang salah, atau parameter yang hilang.

Q2: Apakah kesalahan ini disebabkan oleh koneksi yang diblokir?

Ya. Firewall, proxy, atau perangkat lunak keamanan dapat memblokir koneksi atau mengubah struktur permintaan. Selalu coba uji dengan koneksi Internet langsung untuk mengonfirmasi.

Q3: Kode status apa yang menyertai kesalahan ini?

Biasanya ini berhubungan dengan status HTTP 400—indikator formal dari permintaan yang buruk.

Q4: Apakah ini masalah pada server Anthropic?

Itu mungkin tetapi tidak umum. Kesalahan ini biasanya terjadi di sisi klien kecuali server mengalami masalah, dalam hal ini Anthropic mungkin menerbitkan pemberitahuan atau peringatan status.

Q5: Apakah mencoba API di Postman dapat membantu?

Sangat. Pengujian melalui Postman atau curl membantu mengisolasi penyebab di luar basis kode Anda. Ini adalah cara terbaik untuk memverifikasi bahwa API dapat dijangkau dan struktur permintaan Anda berfungsi.

Q6: Di mana saya dapat menemukan dokumen Anthropic API terbaru?

Anda dapat menemukannya di dokumentasi resmi Anthropic.

Kesimpulan

Mendiagnosis dan memperbaiki kesalahan “Gagal Terhubung ke api.anthropic.com: ERR_BAD_REQUEST” memerlukan pendekatan metodis. Biasanya masalah ini berasal dari konfigurasi sisi klien, permintaan yang salah format, atau kesalahan autentikasi—tetapi dengan memeriksa setiap komponen penyiapan secara cermat, kemungkinan besar Anda akan menyelesaikannya dengan cepat. Selalu baca dokumentasi API untuk mengetahui kompatibilitas dan contohnya, dan gunakan alat pengujian untuk memvalidasi masukan Anda. Jika macet, komunikasi mendetail dengan dukungan dapat menunjukkan masalahnya.