Batas Laju & Kesalahan
Batasannya, dan arti tiap kode status.
429 bisa berasal dari beberapa lapisan:
- Batas model gratis kami: 1 permintaan per menit, per model gratis, per pengguna.
- Batas hulu: penyedia di balik model gratis mencapai batasnya sendiri.
- Anggaran token harian pada sebagian kumpulan gratis, direset pada tengah malam UTC.
- Batas token per menit, terpicu oleh prompt yang sangat besar.
- Batas konkurensi per pengguna untuk permintaan paralel.
Model berbayar tidak memiliki batas laju yang diberlakukan oleh UnoRouter.
Saat batas 1 per menit aktif, Anda menerima header batas laju standar:
HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478Retry-After adalah sisa detik dalam jendela Anda, bukan selalu 60. Pesannya menyebut model berbayar, yang tidak punya batas.
Sebagian model berbayar ditawarkan gratis dengan batas ukuran permintaan. Prompt yang terlalu besar menghasilkan 413: Request body too large for gpt-4.1 model. Max size: 8000 tokens.
Batas itu hanya berlaku pada rute gratis. Model berbayar menerima prompt dengan panjang penuh.
Error dikembalikan sebagai JSON dalam format error OpenAI. code adalah pengenal yang stabil. Id permintaan ditambahkan di setiap pesan:
{
"error": {
"message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
"type": "new_api_error",
"code": "model_not_found"
}
}Sertakan id permintaan di tiket dukungan. Id itu menemukan permintaan Anda di log.
Jika Anda masih menyiapkan kunci atau URL dasar, mulailah dari Panduan cepat
Kode status yang benar-benar akan Anda temui:
| Kode | Arti | Yang harus dilakukan |
|---|---|---|
400 | Permintaan tidak valid: parameter salah, atau prompt diblokir moderasi. | Perbaiki permintaannya. Mengulang tanpa perubahan akan gagal lagi. |
401 | Kunci hilang, tidak valid, kedaluwarsa, atau dinonaktifkan. | Periksa header Authorization dan Tokens page. |
402 | Batas pengeluaran kunci ini sendiri sudah habis. | Naikkan batas kunci atau buat kunci baru. |
403 | Saldo habis, model tidak diizinkan untuk kunci ini, atau IP tidak ada di daftar izin. | Isi ulang, atau periksa batasan model dan IP kunci. |
413 | Permintaan melebihi batas ukuran uji coba gratis model tersebut. | Persingkat prompt atau beralih ke model berbayar. |
429 | Batas laju terpicu (lihat jenisnya di bawah). | Tunggu detik Retry-After, lalu coba lagi atau ganti model. |
500 | Ada yang gagal di pihak kami atau di penyedia upstream. | Coba lagi setelah menunggu sebentar. Laporkan 500 yang terus berulang. |
503 | Semua penyedia sibuk, atau nama modelnya tidak ada. | Baca pesannya: kondisi sibuk hilang dalam hitungan menit, salah ketik tidak. |
Dua situasi yang sangat berbeda berbagi status 503. Yang pertama adalah kemacetan sementara:
HTTP/1.1 503 Service Unavailable
{
"error": {
"message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
"type": "new_api_error",
"code": "get_channel_failed"
}
}get_channel_failed berarti semua penyedia gratis untuk model itu terkena batas laju. Kondisi ini hilang dalam hitungan menit: coba lagi atau ganti model. model_not_found berarti namanya tidak dikenali; mengulang tidak pernah membantu. Periksa salah ketik atau lihat katalognya.
Perlakukan get_channel_failed sebagai error yang bisa diulang dan model_not_found sebagai error permanen.
Model yang hilang karena beban akan kembali sendiri; agar diberi tahu begitu kembali, pantau di Notifikasi
Jika kunci Anda menyematkan grup penyedia, ada 503 ketiga saat hanya grup sematan Anda yang tumbang, lihat Penyematan Grup
Patuhi Retry-After pada 429. Ulangi 503 get_channel_failed setelah menunggu sebentar, atau ganti model. Jangan mengulang error kelas 400.
Permintaan yang gagal atau ditolak tidak pernah ditagih; cara kerja penahanan awal dan pengembalian dijelaskan di Akun & Penagihan