Ringkasan
Penggunaan API tunduk pada batas laju. Batas ini membatasi permintaan, token, atau penggunaan lainnya dalam periode tertentu.
Respons 429 dapat menunjukkan batas laju sementara, saldo prabayar yang habis, atau batas pengeluaran maupun penggunaan. Periksa detail error sebelum mencoba lagi atau mengubah pengaturan penagihan Anda.
Identifikasi penyebabnya
Baca pesan error dan error.code, jika tersedia. Error terkait penagihan masih dapat menggunakan nilai error.type yang lebih umum, yaitu insufficient_quota.
| Error atau kode | Artinya | Tindakan yang perlu dilakukan |
| Batas laju permintaan atau token tercapai | Permintaan melebihi batas laju yang berlaku. | Atur jeda antarpermintaan dan ikuti panduan percobaan ulang di bawah. |
| credit_balance_exhausted | Kredit prabayar organisasi telah habis. | Tambahkan kredit di pengaturan penagihan API Anda. |
| organization_usage_limit_exceeded | Organisasi telah mencapai batas penggunaan yang ditetapkan oleh OpenAI. | Ajukan persetujuan untuk batas penggunaan yang lebih tinggi. |
| organization_spend_limit_exceeded | Organisasi telah mencapai batas pengeluaran yang diberlakukan. | Naikkan atau hapus batas tersebut, atau tunggu reset bulanan. |
| project_spend_limit_exceeded | Proyek telah mencapai batas pengeluaran yang diberlakukan. | Naikkan atau hapus batas proyek tersebut, atau tunggu reset bulanan. |
Mencoba lagi setelah terjadi error penagihan, pengeluaran, atau kuota tidak akan memulihkan akses. Atasi dahulu masalah saldo atau batas yang dilaporkan. Perubahan pada batas pengeluaran yang diberlakukan mungkin memerlukan waktu untuk diterapkan.
Untuk mengubah batas pengeluaran, Anda memerlukan izin mengelola pengaturan organisasi atau proyek terkait. Jika Anda tidak memiliki akses, mintalah bantuan orang yang mengelola pengaturan tersebut.
Untuk pembelian kredit prabayar, lihat: Menyiapkan dan mengelola penagihan API prabayar.
Untuk berbagai kontrol pengeluaran, lihat panduan batas pengeluaran API.
Periksa batas laju yang berlaku
Buka halaman Batas organisasi Anda untuk meninjau tingkat penggunaan dan batas yang berlaku saat ini.
Batas laju dapat berlaku di tingkat organisasi dan proyek. Batas ini bukan alokasi untuk masing-masing pengguna. Batas juga berbeda menurut model, dan beberapa keluarga model menggunakan satu batas bersama.
Periksa batas mana yang disebutkan dalam error. Misalnya, permintaan per menit dan token per menit memiliki batas yang terpisah. Anda dapat mencapai salah satu batas sementara masih di bawah batas lainnya.
Periksa batas API pembuatan gambar
Batas laju API pembuatan gambar bergantung pada model dan tingkat penggunaan Anda. Pilih model Anda di halaman model untuk melihat batasnya.
Untuk petunjuk penyiapan, lihat panduan developer untuk pembuatan gambar. Untuk informasi selengkapnya tentang tingkat penggunaan, lihat panduan batas laju API.
Pastikan organisasi yang digunakan oleh permintaan Anda
Jika Anda tergabung dalam beberapa organisasi, pastikan permintaan Anda menggunakan organisasi dan proyek yang dimaksud.
Jika kunci API Anda menggunakan organisasi default, periksa pengaturan organisasi default Anda. Setiap organisasi dapat memiliki pengaturan penagihan dan tingkat penggunaan yang berbeda.
Kurangi error batas laju sementara
Atur jeda antarpermintaan dan hindari lonjakan
Kirim permintaan secara bertahap, bukan dalam jumlah besar sekaligus.
Batas laju dapat diberlakukan dalam periode yang lebih pendek daripada interval yang ditampilkan. Misalnya, batas 60 permintaan per menit juga dapat diberlakukan dalam periode 1 detik. Karena itu, lonjakan singkat dapat memicu error meskipun penggunaan rata-rata Anda tampak di bawah batas per menit.
Prompt yang panjang dan alokasi token output yang terlalu besar juga dapat berkontribusi pada error batas laju token.
Beri jeda sebelum mencoba lagi
Untuk error batas laju sementara:
Periksa apakah ada header respons Retry-After.
Jika header berisi durasi jeda yang valid, tunggu setidaknya selama durasi tersebut sebelum mencoba lagi.
Jika header tidak ada atau tidak valid, gunakan backoff eksponensial dengan jitter: perpanjang jeda setiap kali percobaan gagal dan tambahkan jeda acak singkat.
Batasi jumlah percobaan ulang serta total waktu yang dihabiskan untuk mencoba lagi.
SDK resmi OpenAI sudah otomatis mencoba ulang permintaan yang mengalami error batas laju yang memenuhi syarat dan mengikuti Retry-After jika tersedia. Perhitungkan percobaan ulang tersebut sebelum menambahkan loop percobaan ulang lainnya.
Permintaan yang gagal tetap dihitung dalam batas per menit. Terus mengirim ulang permintaan yang sama dapat memperpanjang masalah.
Untuk panduan implementasi dan contoh, lihat panduan batas laju API. Tinjau pustaka percobaan ulang pihak ketiga sebelum menggunakannya dalam aplikasi Anda.
Tinjau ukuran prompt dan output
Hapus instruksi yang tidak perlu, konteks yang berulang, dan contoh dari prompt Anda. Uji prompt yang telah direvisi untuk memastikan hasilnya masih sesuai kebutuhan Anda.
Gunakan parameter token output yang didukung oleh endpoint dan model Anda:
Chat Completions menggunakan max_completion_tokens.
Responses menggunakan max_output_tokens.
Hindari menetapkan alokasi yang jauh lebih besar daripada kebutuhan permintaan. Parameter ini mencakup token penalaran serta output yang terlihat, jadi alokasikan ruang untuk keduanya saat menggunakan model penalaran.
Tinjau tingkat penggunaan Anda
Jika error terus terjadi setelah Anda mengurangi lonjakan dan meninjau penggunaan token, periksa halaman Batas untuk melihat opsi yang tersedia guna menaikkan batas Anda.
Tingkat penggunaan berbayar organisasi Anda naik secara otomatis saat total pembelian kreditnya mencapai ambang Build, Launch, dan Grow. Tingkat yang lebih tinggi umumnya memberikan batas laju yang lebih tinggi. Lihat panduan batas laju API untuk mengetahui persyaratan tiap tingkat.
Batas penggunaan bulanan yang disetujui untuk Anda terpisah dari batas laju permintaan dan token. Kenaikan salah satu batas tidak berarti batas lainnya juga telah berubah.
Jika masalah berlanjut
Sebelum meminta bantuan lebih lanjut
Siapkan pesan error persis seperti yang muncul, kode error jika ada, ID permintaan terkait, waktu terjadinya error beserta zona waktu Anda, dan batas terkait yang ditampilkan di akun Anda. Catat langkah-langkah yang sudah Anda coba.
Hubungi Dukungan OpenAI
Hubungi Dukungan OpenAI melalui Pusat Bantuan jika Anda tidak dapat mengatasi masalah setelah memeriksa batas yang dilaporkan. Jangan sertakan kunci API atau informasi rahasia autentikasi lainnya.