Arti error 502 Bad Gateway, 503 dan 504 Gateway Timeout di API AI
502/504Server di belakang gateway gangguan, penuh, atau terlalu lama menjawab.
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
502 Bad Gateway: server perantara menerima jawaban rusak atau koneksi terputus dari server di belakangnya. 503 Service Unavailable: layanan atau rute sedang tidak tersedia. 504 Gateway Timeout: server di belakang tidak menjawab dalam batas waktu.
Semua ini biasanya bukan kesalahan key atau kodemu. Yang bisa kamu atur adalah cara mengulang, panjang request dan batas waktu di aplikasimu.
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.
- HTTP
502 Bad Gateway · 503 Service Unavailable · 504 Gateway Timeout - Anthropic
overloaded_error (529) - Cloudflare
Error 524: A timeout occurred
Penyebab umum
- Penyedia model sedang gangguan atau penuh.
- Request non-stream yang sangat lama: model reasoning, output panjang, atau prompt ratusan ribu token.
- Batas waktu di aplikasi, proxy atau CDN lebih pendek dari waktu yang dibutuhkan model.
- Gangguan jaringan antara aplikasimu dan server.
Cara memperbaiki, langkah demi langkah
- Ulangi dengan jeda. Error ini sering sementara. Ulangi 2–3 kali dengan jeda yang makin panjang.
- Pakai streaming. Kirim "stream": true untuk jawaban panjang dan model reasoning. Data mulai mengalir sebelum jawaban selesai, sehingga koneksi tidak dianggap menganggur.
- Naikkan timeout di aplikasimu. Claude Code: export API_TIMEOUT_MS=600000. OpenAI SDK Python: OpenAI(timeout=600). n8n: atur Timeout di opsi node.
- Kecilkan request. Pangkas konteks dan turunkan max_tokens supaya model selesai lebih cepat.
- Cek halaman status. Kalau satu model terus gagal, cek halaman status penyedia dan pindah ke model lain sementara.
Di Ezkielyna API
- Kondisi gateway dan tiap model, dari request nyata, ada di halaman status api.ezkielyna.store/status. Persentase sukses 24 jam per model juga tampil di halaman peringkat.
- Menurut dokumentasi Ezkielyna API, halaman 524 dari Cloudflare berarti request non-stream berjalan lebih dari 100 detik; pakai "stream": true untuk jawaban panjang dan model reasoning.
Gagal = Gratis
Request chat yang gagal karena error di server Ezkielyna atau upstream, sehingga jawabannya kosong atau terputus sebelum ada teks, dikembalikan otomatis ke saldo. Sistem memeriksa log setiap 10 menit dan refund tampil di menu Log. Tidak termasuk: pembatalan atau timeout dari sisi aplikasimu, gambar, video, audio dan task async, serta bagian di atas $1 per pengguna per 24 jam. Aturan lengkap.
Alat bantu: daftar model dan grup
Pertanyaan umum
Apakah saya tetap ditagih kalau request 502 atau 504?
Tergantung penyedia. Di Ezkielyna, request chat yang gagal karena error di server kami atau upstream sebelum ada jawaban dikembalikan otomatis ke saldo (Gagal = Gratis), dengan pengecualian yang tertulis di halaman jaminan.
Timeout terjadi di aplikasi saya, bukan di server. Apakah dikembalikan?
Di Ezkielyna tidak. Pembatalan dari sisi klien, termasuk timeout di aplikasimu sendiri, bukan kegagalan server.
In English
502, 503 and 504 mean the gateway got a bad, missing or late answer from the server behind it; usually temporary and not caused by your key. Retry with backoff, stream long answers, raise client timeouts (Claude Code API_TIMEOUT_MS, OpenAI SDK timeout) and check the status page. On Ezkielyna, chat requests that fail on our side or upstream before any answer are refunded automatically (Gagal = Gratis).