Soalan lazim API
401, model tidak ditemui, tamat masa, 429, balasan terpotong — simptom dan penyelesaian.
Soalan berfrekuensi tinggi tentang panggilan API. Padankan simptom anda, kemudian ikut pautan untuk butiran.
Mendapat 401 Unauthorized?
- Kunci salah: pastikan anda menggunakan kunci penuh yang disimpan semasa penciptaan (entri senarai yang bertopeng bukan kunci penuh);
- Kunci dipadam atau luput: sahkan statusnya di halaman "Kunci API" dan cipta semula jika perlu;
- Pengepala tidak betul: protokol serasi OpenAI menjangkakan
Authorization: Bearer <key>— jangan tinggalkan awalanBearer; - Maklumat lanjut dalam Pengesahan.
"Model not found"?
- ID model tersalah eja — salin ID yang tepat daripada pasaran model dan jangan taip sendiri;
- Model itu tidak wujud di platform ini atau sedang tidak tersedia — semak sama ada kadnya wujud dan tersedia di pasaran.
Tamat masa atau respons perlahan?
- Permintaan berkonteks panjang / output panjang sememangnya lebih perlahan; semak sama ada
max_tokensditetapkan terlalu tinggi tanpa keperluan; - Tetapkan tamat masa dan cubaan semula klien yang wajar dengan undur eksponen;
- Untuk antara muka interaktif, gunakan
"stream": true— bait pertama tiba lebih awal dan kependaman yang dirasai berkurang.
Kerap mendapat 429?
Anda mencapai had kadar. Kurangkan konkurensi, tambah selang undur; untuk beban tinggi yang berterusan, hubungi platform mengenai kuota. Lihat Kod ralat.
Balasan kosong atau terpotong?
finish_reasonialahlength: balasan mencapai hadmax_tokens— naikkannya;- Semak bahawa tiada entri
messagesyang membawacontentkosong; - Sesetengah model mengekang format input (contohnya keperluan modaliti imej) — lihat nota pada kad model.
Bagaimana saya mengesahkan sesuatu panggilan benar-benar berjaya?
Dua titik semak: HTTP 200 dengan choices / usage dalam respons; dan rekod yang sepadan (dengan penggunaan token dan kos) pada halaman log konsol. Apabila kedua-duanya bersetuju, saluran itu sihat.

