Gambaran keseluruhan
Penggunaan API tertakluk pada had kadar. Had ini mengehadkan permintaan, token atau penggunaan lain dalam tempoh yang ditetapkan.
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 disediakan. 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 permintaan atau token telah dicapai | Permintaan melebihi had kadar yang berkenaan. | Jarakkan penghantaran permintaan dan ikut panduan percubaan semula di bawah. |
| credit_balance_exhausted | Organisasi tiada lagi baki kredit prabayar. | Tambah kredit dalam tetapan pengebilan API anda. |
| organization_usage_limit_exceeded | Organisasi telah mencapai had penggunaan yang ditetapkan oleh OpenAI. | Mohon kelulusan untuk had penggunaan yang lebih tinggi. |
| organization_spend_limit_exceeded | Organisasi telah mencapai had perbelanjaan yang dikuatkuasakan. | Naikkan atau alih keluar had tersebut, atau tunggu penetapan semula bulanan. |
| project_spend_limit_exceeded | Projek telah mencapai had perbelanjaan yang dikuatkuasakan. | Naikkan atau alih keluar had projek tersebut, atau tunggu penetapan semula bulanan. |
Mencuba semula selepas ralat pengebilan, perbelanjaan atau kuota tidak akan memulihkan akses. Selesaikan dahulu isu baki atau had yang dilaporkan. Perubahan pada had perbelanjaan yang dikuatkuasakan mungkin mengambil masa untuk berkuat kuasa.
Untuk mengubah had perbelanjaan, anda 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 maklumat tentang 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 setiap pengguna secara individu. Had juga berbeza mengikut model, dan sesetengah keluarga model berkongsi had yang sama.
Semak had yang dinyatakan dalam ralat. Contohnya, permintaan seminit dan token seminit mempunyai had yang berasingan. Anda boleh mencapai satu had sementara penggunaan bagi yang satu lagi masih di bawah had.
Semak had API penjanaan imej
Had kadar API penjanaan imej bergantung pada model dan peringkat penggunaan anda. Pilih model anda pada halaman model untuk melihat hadnya.
Untuk arahan persediaan, lihat panduan pembangun untuk penjanaan imej. Untuk maklumat lanjut tentang peringkat penggunaan, lihat panduan had kadar API.
Sahkan organisasi yang digunakan oleh permintaan anda
Jika anda ahli beberapa organisasi, pastikan permintaan anda menggunakan organisasi dan projek yang dimaksudkan.
Apabila kunci API anda menggunakan organisasi lalai, semak tetapan organisasi lalai anda. Setiap organisasi boleh mempunyai aturan pengebilan dan peringkat penggunaan yang berbeza.
Kurangkan ralat had kadar sementara
Jarakkan permintaan dan elakkan lonjakan
Hantar permintaan secara berperingkat dan bukannya dalam jumlah yang besar serentak.
Had kadar boleh dikuatkuasakan untuk tempoh yang lebih singkat daripada selang masa yang dipaparkan. Contohnya, had 60 permintaan seminit juga mungkin dikuatkuasakan untuk tempoh 1 saat. Oleh itu, lonjakan singkat boleh mencetuskan ralat walaupun purata penggunaan anda kelihatan di bawah had seminit.
Prom yang panjang dan peruntukan token output yang terlalu besar juga boleh menyumbang kepada ralat kadar token.
Tunggu sebelum mencuba semula
Untuk ralat had kadar sementara:
Semak sama ada pengepala respons Retry-After disertakan.
Jika pengepala mengandungi tempoh menunggu yang sah, tunggu sekurang-kurangnya selama tempoh itu sebelum mencuba semula.
Jika pengepala tiada atau tidak sah, gunakan penangguhan eksponen dengan variasi rawak: panjangkan tempoh menunggu selepas setiap percubaan yang gagal dan tambahkan sedikit tempoh menunggu secara rawak.
Hadkan bilangan percubaan semula serta jumlah masa yang digunakan untuk mencuba semula.
SDK rasmi OpenAI sudah pun mencuba semula permintaan yang mengalami ralat had kadar yang layak dan mematuhi Retry-After apabila disertakan. Ambil kira percubaan semula tersebut sebelum menambahkan satu lagi gelung percubaan semula.
Permintaan yang gagal turut dikira dalam had seminit. Menghantar semula permintaan yang sama secara berterusan boleh memanjangkan masalah.
Untuk panduan pelaksanaan dan contoh, lihat panduan had kadar API. Semak mana-mana pustaka percubaan semula pihak ketiga sebelum menggunakannya dalam aplikasi anda.
Semak saiz prom dan output
Buang arahan, konteks berulang dan contoh yang tidak diperlukan daripada prom anda. Uji prom yang telah disemak untuk memastikan prom itu masih menghasilkan hasil 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 sediakan peruntukan untuk kedua-duanya apabila menggunakan model penaakulan.
Semak peringkat penggunaan anda
Jika ralat berterusan selepas anda mengurangkan lonjakan permintaan dan menyemak penggunaan token, semak halaman Had anda untuk mengetahui cara yang tersedia bagi menaikkan had anda.
Peringkat penggunaan berbayar organisasi anda dinaik taraf secara automatik apabila jumlah pembelian kreditnya mencapai ambang Build, Launch dan Grow. Peringkat yang lebih tinggi biasanya menyediakan had kadar yang lebih tinggi. Lihat panduan had kadar API untuk syarat setiap peringkat.
Had penggunaan bulanan anda yang diluluskan adalah berasingan daripada had kadar permintaan dan token. Kenaikan satu had tidak harus dianggap sebagai pengesahan bahawa had yang lain turut berubah.
Jika masalah berterusan
Sebelum merujuk masalah kepada sokongan
Sediakan mesej ralat yang tepat, sebarang kod ralat, ID permintaan yang berkaitan, waktu ralat berlaku 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 maklumat rahsia pengesahan yang lain.