Had Kadar

Had kadar ialah sekatan yang dikenakan oleh API kami ke atas bilangan kali seseorang pengguna atau klien boleh mengakses perkhidmatan kami dalam tempoh masa yang ditetapkan.

Kenapa Had Diperlukan

Kami telah menetapkan had kadar pada API kami untuk membantu mewujudkan pengalaman terbaik untuk semua orang. Berikut adalah sebab mengapa ia penting:

Untuk memastikan perkhidmatan kami selamat dan terjamin! Anggaplah had kadar sebagai penjaga pintu yang mesra - mereka memastikan tiada sesiapa boleh membebankan API kami dengan terlalu banyak permintaan sekali gus. Ini membantu melindungi perkhidmatan kami daripada penyalahgunaan yang berpotensi dan memastikan semuanya berjalan lancar.
Untuk memastikan setiap orang mendapat bahagian yang adil. Sama seperti berkongsi mainan di taman permainan, kami mahu memastikan semua pengguna kami mempunyai akses yang sama rata kepada API. Dengan menghadkan bilangan permintaan yang boleh dibuat oleh setiap pengguna secara berhemah, kami memastikan tiada sesiapa perlu menunggu terlalu lama untuk giliran mereka.
Untuk memastikan prestasi kekal pantas dan boleh dipercayai. Dengan menguruskan aliran keseluruhan permintaan, kami dapat mengekalkan masa tindak balas yang pantas dan perkhidmatan yang stabil untuk semua pengguna kami yang hebat. Ia seperti memastikan lebuh raya tidak terlalu sesak - trafik mengalir lebih lancar apabila kami mencegah kesesakan!

Cara Had Berfungsi

Had kadar diukur dengan 2 cara:

Permintaan Sesaat: Ini ialah bilangan permintaan rangkaian yang anda boleh buat sesaat.
Tugas Beratur: Ini ialah bilangan tugas penjanaan serentak yang anda boleh jalankan dalam giliran pada bila-bila masa.

Tugas beratur termasuk endpoint Teks ke 3D, Imej ke 3D, Teks ke Tekstur, dan Remesh. Endpoint lain seperti Muat Naik dan Baki tidak termasuk dalam had ini.

Had ini dikenakan berdasarkan setiap akaun. Ini bermakna had tersebut dikongsi merentasi semua API key anda.

Selain had kadar, keutamaan pemprosesan tugas juga akan mempengaruhi kelajuan tugas anda.

Setiap peringkat pengguna mempunyai had kadar dan tahap keutamaan tertentu yang direka bentuk untuk memenuhi keperluan mereka. Berikut ialah had semasa mengikut peringkat:

Peringkat Pengguna	Permintaan Sesaat	Tugas Beratur	Tahap Keutamaan
Pro	20	10	Lalai
Premium	20	30	Lebih tinggi daripada Pro
Ultra	20	100	Tertinggi
Studio	20	20	Lebih tinggi daripada Pro
Enterprise	100	Lalai kepada 100, boleh disesuaikan	Tertinggi

Jika anda melebihi had ini, anda akan menerima respons 429 Too Many Requests daripada API kami. Terdapat dua jenis kejadian yang boleh mencetuskan ini, setiap satu dengan respons yang berbeza:

Kejadian Permintaan: Ini berlaku apabila anda membuat terlalu banyak permintaan sesaat. Anda akan menerima respons 429 Too Many Requests dengan mesej RateLimitExceeded.
Kejadian Giliran: Ini berlaku apabila anda mempunyai terlalu banyak tugas penjanaan serentak yang sedang berjalan. Anda akan menerima respons 429 Too Many Requests dengan mesej NoMoreConcurrentTasks.