Gambaran keseluruhan
Penggunaan API tertakluk pada had kadar. Had ini mengehadkan permintaan, token atau penggunaan lain dalam tempoh tertentu.
Respons 429 boleh menunjukkan had kadar sementara, baki prabayar yang telah habis atau had perbelanjaan atau penggunaan. Semak butiran ralat sebelum mencuba semula atau mengubah tetapan pengebilan anda.
Kenal pasti puncanya
Baca mesej ralat dan error.code, jika diberikan. Ralat berkaitan pengebilan masih boleh menggunakan nilai error.type yang lebih umum, iaitu insufficient_quota.
| Ralat atau kod | Maksudnya | Tindakan yang perlu diambil |
| Had kadar untuk permintaan atau token telah dicapai | Permintaan melebihi had kadar yang berkenaan. | Kawal kadar permintaan dan ikuti panduan percubaan semula di bawah. |
| credit_balance_exhausted | Organisasi tersebut tidak mempunyai baki kredit prabayar. | Tambah kredit dalam tetapan pengebilan API anda. |
| organization_usage_limit_exceeded | Organisasi tersebut telah mencapai had penggunaan yang ditetapkan oleh OpenAI. | Minta had penggunaan diluluskan yang lebih tinggi. |
| organization_spend_limit_exceeded | Organisasi tersebut telah mencapai had perbelanjaan yang dikuatkuasakan. | Tingkatkan atau alih keluar had tersebut, atau tunggu sehingga penetapan semula bulanan. |
| project_spend_limit_exceeded | Projek tersebut telah mencapai had perbelanjaan yang dikuatkuasakan. | Tingkatkan atau alih keluar had projek tersebut, atau tunggu sehingga penetapan semula bulanan. |
Mencuba semula selepas ralat pengebilan, perbelanjaan atau kuota tidak akan memulihkan akses. Selesaikan dahulu masalah baki atau had yang dilaporkan. Perubahan pada had perbelanjaan yang dikuatkuasakan mungkin mengambil masa untuk diterapkan.
Mengubah had perbelanjaan memerlukan kebenaran untuk mengurus tetapan organisasi atau projek yang berkenaan. Jika anda tiada akses, minta bantuan orang yang mengurus tetapan tersebut.
Untuk pembelian kredit prabayar, lihat: Menyediakan dan mengurus pengebilan API prabayar.
Untuk pelbagai kawalan perbelanjaan, lihat panduan had perbelanjaan API.
Semak had kadar yang berkenaan
Pergi ke halaman Had organisasi anda untuk menyemak peringkat penggunaan dan had semasanya.
Had kadar boleh dikenakan pada peringkat organisasi dan projek. Had ini bukan peruntukan untuk pengguna individu. Had juga berbeza mengikut model dan sesetengah keluarga model berkongsi had.
Semak had yang dikenal pasti oleh ralat tersebut. Contohnya, permintaan seminit dan token seminit merupakan had yang berasingan. Anda boleh mencapai satu had tetapi masih berada di bawah had yang lain.
Sahkan organisasi yang digunakan oleh permintaan anda
Jika anda menyertai berbilang organisasi, pastikan permintaan anda menggunakan organisasi dan projek yang dimaksudkan.
Apabila kunci API anda menggunakan organisasi lalai, semak tetapan organisasi lalai anda. Organisasi yang berbeza boleh mempunyai aturan pengebilan dan peringkat penggunaan yang berbeza.
Kurangkan ralat had kadar sementara
Kawal kadar permintaan dan elakkan lonjakan
Agihkan permintaan sepanjang suatu tempoh dan bukannya menghantar banyak permintaan serentak.
Had kadar boleh dikuatkuasakan dalam tempoh yang lebih singkat daripada selang yang dipaparkan. Contohnya, had 60 permintaan seminit juga boleh dikuatkuasakan dalam tempoh 1 saat. Oleh itu, lonjakan singkat boleh mencetuskan ralat walaupun penggunaan purata anda kelihatan di bawah had seminit.
Prom yang panjang dan peruntukan token output yang terlalu besar juga boleh menyumbang kepada ralat kadar token.
Cuba semula selepas suatu sela masa
Untuk ralat had kadar sementara:
Semak pengepala respons Retry-After.
Jika pengepala mengandungi tempoh menunggu yang sah, tunggu sekurang-kurangnya selama tempoh itu sebelum mencuba semula.
Jika pengepala tiada atau tidak sah, gunakan undur eksponen dengan hingar rawak: tambah tempoh menunggu selepas setiap percubaan yang gagal dan sertakan sedikit tempoh menunggu rawak.
Hadkan bilangan percubaan semula dan jumlah masa yang digunakan untuk mencuba semula.
SDK rasmi OpenAI sudah mencuba semula ralat had kadar yang layak dan mematuhi Retry-After apabila tersedia. Ambil kira percubaan semula tersebut sebelum menambahkan gelung percubaan semula yang lain.
Permintaan yang gagal turut dikira dalam had seminit. Menghantar semula permintaan yang sama secara berterusan boleh memanjangkan masalah.
Untuk panduan dan contoh pelaksanaan, lihat panduan had kadar API. Semak mana-mana pustaka percubaan semula pihak ketiga sebelum menggunakannya dalam aplikasi anda.
Semak saiz prom dan output
Alih keluar arahan yang tidak perlu, konteks berulang dan contoh daripada prom anda. Uji prom yang disemak untuk memastikan prom itu masih menghasilkan keputusan yang anda perlukan.
Gunakan parameter token output yang disokong oleh titik akhir dan model anda:
Chat Completions menggunakan max_completion_tokens.
Responses menggunakan max_output_tokens.
Elakkan menetapkan peruntukan yang jauh lebih besar daripada keperluan permintaan. Parameter ini merangkumi token penaakulan serta output yang kelihatan, jadi peruntukkan ruang untuk kedua-duanya apabila menggunakan model penaakulan.
Semak peringkat penggunaan anda
Jika ralat berterusan selepas anda mengurangkan lonjakan dan menyemak penggunaan token, semak halaman Had untuk mengetahui cara yang tersedia bagi meningkatkan had anda.
Apabila perbelanjaan API meningkat, OpenAI boleh menaikkan organisasi secara automatik ke peringkat penggunaan yang lebih tinggi. Ini biasanya meningkatkan had kadar untuk kebanyakan model.
Had penggunaan bulanan yang diluluskan untuk anda berasingan daripada had kadar permintaan dan token. Peningkatan satu had tidak seharusnya dianggap sebagai pengesahan bahawa had yang lain turut berubah.
Jika masalah berterusan
Sebelum mendapatkan bantuan lanjut
Sediakan mesej ralat yang tepat, sebarang kod ralat, ID permintaan yang berkaitan, waktu ralat berserta zon waktu anda dan had berkaitan yang dipaparkan dalam akaun anda. Catat langkah yang telah anda cuba.
Hubungi Sokongan OpenAI
Hubungi Sokongan OpenAI melalui Pusat Bantuan jika anda tidak dapat menyelesaikan masalah selepas menyemak had yang dilaporkan. Jangan sertakan kunci API atau rahsia pengesahan lain.