Tanya jawab API

401, model tidak ditemukan, timeout, 429, balasan terpotong — gejala dan solusinya.

Pertanyaan yang sering muncul seputar panggilan API. Cocokkan gejala Anda, lalu ikuti tautan untuk detailnya.

Mendapat 401 Unauthorized?

Kunci salah: pastikan Anda memakai kunci lengkap yang disimpan saat pembuatan (entri daftar yang tersamarkan bukan kunci lengkapnya);
Kunci dihapus atau kedaluwarsa: pastikan statusnya di halaman "API Keys" dan buat ulang jika perlu;
Header tidak sesuai: protokol kompatibel OpenAI mengharapkan Authorization: Bearer <key> — jangan hilangkan prefiks Bearer ;
Selengkapnya di Autentikasi.

"Model not found"?

ID model salah tulis — salin ID persisnya dari pasar model alih-alih mengetiknya;
Model tidak ada di platform atau sedang tidak tersedia — periksa bahwa kartunya ada dan tersedia di pasar model.

Timeout atau respons lambat?

Permintaan berkonteks panjang / keluaran panjang memang lebih lambat; periksa apakah max_tokens diatur terlalu tinggi tanpa perlu;
Setel timeout klien dan percobaan ulang yang wajar dengan backoff eksponensial;
Untuk antarmuka interaktif gunakan "stream": true — byte pertama tiba lebih cepat dan latensi yang dirasakan menurun.

Sering mendapat 429?

Anda terkena batas laju. Turunkan konkurensi, tambahkan interval backoff; untuk beban tinggi yang berkelanjutan, hubungi platform soal kuota. Lihat Kode kesalahan.

Balasan kosong atau terpotong?

finish_reason bernilai length: balasan mencapai batas max_tokens — naikkan nilainya;
Periksa bahwa tidak ada entri messages yang membawa content kosong;
Sebagian model membatasi format masukan (misalnya persyaratan modalitas gambar) — lihat catatan pada kartu model.

Bagaimana memastikan panggilan benar-benar berhasil?

Dua titik pemeriksaan: HTTP 200 dengan choices / usage pada respons; dan catatan yang cocok (beserta penggunaan token dan biaya) di halaman logs dasbor. Jika keduanya sesuai, alurnya sehat.