Koneksi dan Penggunaan

Saat panggilan gagal atau percakapan terputus, periksa terlebih dahulu tiga hal dengan permintaan minimal: autentikasi, jalur endpoint, dan ketersediaan model.

Tidak dapat terhubung ke platform?

Periksa:

• Apakah kunci API dikonfigurasi dengan benar, tanpa spasi atau baris baru tambahan.
• Apakah Base URL benar dan tidak mengandung jalur ganda.
• Apakah jalur endpoint sesuai dengan protokol klien, misalnya jalur yang kompatibel dengan OpenAI untuk klien OpenAI.
• Apakah jaringan lokal, proksi perusahaan, firewall, DNS, atau inspeksi HTTPS memblokir permintaan.
• Apakah kunci API telah kedaluwarsa, dihapus, atau dimiliki akun yang dibatasi.

Untuk panggilan yang kompatibel dengan OpenAI, uji dengan permintaan minimal tanpa streaming:

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Jika permintaan minimal gagal, masalah biasanya berada pada jaringan, autentikasi, konfigurasi jalur, izin model, atau status akun.

Model sudah dipilih tetapi tidak ada respons atau muncul kesalahan?

Penyebab umum:

• ID model salah atau tidak sesuai dengan daftar model platform.
• Model yang dipilih sementara tidak tersedia atau tidak diizinkan untuk kunci API tersebut.
• Format permintaan tidak valid, misalnya nama kolom, susunan bertingkat, atau jenis data yang salah.
• Saldo akun tidak cukup, konteks terlalu panjang, output terlalu panjang, atau layanan melewati batas waktu.
• Klien pihak ketiga tidak menangani streaming atau respons kesalahan dengan benar.

Salin ID model persis dari konsol atau daftar model, uji dengan isi permintaan minimal, lalu tambahkan kembali konteks dan parameter secara bertahap.

Bagaimana jika percakapan mengalami kesalahan atau terputus?

Tentukan titik kegagalannya:

• Sebelum permintaan dimulai: periksa autentikasi, jalur, model, dan parameter.
• Selama streaming: periksa batas waktu klien, rangkaian proksi, dan penguraian SSE.
• Dengan konteks atau output panjang: periksa ukuran permintaan, batas output, dan batas waktu layanan.

Penanganan yang disarankan:

1. Baca kolom kesalahan yang spesifik.
2. Beralih sementara ke mode tanpa streaming untuk membedakan kegagalan model dari kegagalan penguraian streaming.
3. Tambahkan percobaan ulang dengan jeda bertahap untuk 429, ketidakstabilan jaringan, dan sebagian kesalahan 5xx.
4. Sertakan konteks yang diperlukan saat mencoba ulang, bukan mengasumsikan adanya status percakapan di server.
5. Catat X-Request-ID jika masalah berlanjut.