Had Kadar

Had kadar adalah sekatan yang dikenakan oleh API kami terhadap bilangan kali pengguna atau klien boleh mengakses perkhidmatan kami dalam tempoh masa yang ditetapkan.

Mengapa Had

Kami telah menetapkan had kadar pada API kami untuk membantu mencipta pengalaman terbaik untuk semua orang. Ini sebabnya mengapa ia penting:

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

Bagaimana Had Berfungsi

Had kadar diukur dalam 2 cara:

Permintaan sesaat: Ini adalah bilangan permintaan rangkaian yang boleh anda buat setiap saat.
Tugas beratur: Ini adalah bilangan tugas penjanaan serentak yang boleh anda jalankan dalam barisan pada bila-bila masa.

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

Had dikenakan berdasarkan setiap akaun. Ini bermakna had dikongsi di seluruh 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 untuk memenuhi keperluan mereka. Berikut adalah had semasa mengikut peringkat:

Peringkat Pengguna	Permintaan sesaat	Tugas beratur	Tahap Keutamaan
Pro	20	10	Default
Premium	20	30	Lebih tinggi daripada Pro
Ultra	20	100	Tertinggi
Studio	20	20	Lebih tinggi daripada Pro
Enterprise	100	Default kepada 50, boleh disesuaikan	Tertinggi

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

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